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1 Introduction to the 
IMS F003C 


The IMS F003C is a 2D (two dimensional) graphics package for/q Systems graph- 
ics board products. It provides functional conformance with a subset of the Com- 
puter Graphics Interface (CGI) standard. 

Applications can be developed in the C or Occam programming languages for an 
arbitrary network of transputers. Graphical output is obtained by installing an ap- 
propriate zq Systems graphics board somewhere in the network and programming 
it using the IMS F003C software package. 

The IMS F003C is compatible with INMOS software development toolsets. Devel- 
opers incorporate IMS F003C with their own application software using an appro- 
priately selected C or Occam toolset. 


1.1 Prerequisites 

In order to develop applications with the IMS F003C the following environments 
are required: 

1.1.1 Hardware 

• IBM PC AT or compatible personal computer 

• IMS B008 IBM PC AT TRAM motherboard 

• IMS B419 graphics TRAM 
OR 

• IMS B437 compact display TRAM 

1.1.2 Software 

• IMS D7214 ANSI C Toolset for IBM PC AT 
OR 

• IMS D7205 Occam Toolset for IBM PC AT 
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1.2 Organisation of the manual 

This manual is split into ten Chapters and four appendices. 

Chapter 2 provides step by step instructions for installing the IMS F003C software 
on an IBM PC AT or compatible computer. 

Chapter 3 contains an overview of the software components contained in the IMS 
F003C package and describes some potential development environments. 

A detailed description of CGI concepts is provided in Chapter 4. Readers familiar 
with 2D computer graphics systems may choose to overlook this Chapter. 

Chapter 5 contains a detailed explanation of graphics board concepts with particu- 
lar reference to <q Systems graphics board products. Again, readers familiar with 
these concepts may wish to overlook this Chapter. 

An alphabetical description of the CGI library and graphics board utility functions 
can be found in Chapters 6 and 7. 

Chapter 8 describes how to develop software using IMS F003C in conjunction with 
an ANSI C toolset. Occam toolset users should instead read Chapter 9, which con- 
tains an equivalent Occam user guide. Both Chapters also contain annotated ex- 
ample source code and instructions for compiling and executing examples in- 
cluded on the installation disks. 

The final Chapter looks into a number of more advanced topics. For example, an 
explanation of the text font format and a description of multi-frame animation tech- 
niques can be found in this Chapter. 

Engineering data for the r'q Systems graphics board products supported by IMS 
F003C can be found in the appendices. Memory and register address maps are 
provided together with more detailed hardware information. 


1.2.1 Manual conventions 

Throughout this manual, reference to software routines and constants will be made 
using ANSI C syntax. Equivalent Occam names may be derived by substituting 
occurrences of the ' J (underscore) character with a ‘ . (period) character as appro- 
priate. 

Source code fragments and operating system command lines will be printed in a 
teletype style font. 
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2 Software installation 


The installation of IMS F003C requires at least 2Mbytes of free disk space be avail- 
able on the host computer system hard disk. 

IMS F003C is distributed on two 1 .2Mbyte 5 1/4" floppy disks or on two 720K byte 
3 1/2" diskettes. The disks can be found in a transparent wallet at the rear of the 
manual. Select the appropriate disks for your system. 

To install IMS F003C from floppy disk drive A: onto hard disk drive C : of an IBM 
PC AT or compatible computer proceed as follows: 

1 Insert the disk labelled disk 1 of 2, into disk drive A: 

2 Change current working directory to C: V 

3 At the operating system command prompt, type a: install a c. 

4 Respond as appropriate to prompts made by the install program. 

5 Insert the second disk (labelled disk 2 of 2) when prompted. 

The installation procedure will create and install IMS F003C files under the directo- 
ry C : \F003C. See Appendix A for details of the directory structure and a list of the 
files that should be present after installation. 

The file C: \F003C\install2.bat may be deleted after installation. 
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3 Overview of the 
IMS F003C 

The IMS F003C software package consists of the following components: 

• CGI display server 

• ANSI C and Occam interface libraries 

• Include files 

• iq Systems graphics board support libraries 

• Source code of the board support libraries 

• Example source code 


3.1 CGI display server 

The CGI display server is a process that runs in parallel with application software 
and provides access to a graphics board. It is responsible for programming the 
graphics board hardware and for performing CGI operations when requested by 
an application program. Graphical output is displayed on an output monitor con- 
nected to the graphics board. The CGI display server may be configured to run on 
any of the iq Systems graphics boards, it is linked with a board specific library that 
provides it a device independent interface to the hardware. 

The CGI display server may run in parallel with application software on the same 
transputer (the graphics board), or with the application running on an adjacent 
transputer network ora mixture of the two. This arrangement is shown in the follow- 
ing diagrams, where a mixture of TRAM motherboards, general purpose compute 
TRAMs and graphics TRAMs are used to build various transputer systems capable 
of generating graphical output via an attached monitor. 
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High resolution monitor 




Figure 3.1 


This shows an IMS B008 TRAM motherboard and an IMS B419 graphics TRAM. 
The graphics TRAM is connected to a high resolution monitor. The application pro- 
gram is hosted by an ISERVER running on an IBM PC AT development host and 
consists of a number of processes running in parallel with the CGI display server. 
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Figure 3.2 

This also shows an IMS B008 TRAM motherboard. It is configured with two general 
purpose compute TRAMs and an IMS B437 compact display TRAM. Again, the 
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graphics TRAM is connected to a high resolution monitor. The CGI server runs by 
itself on the graphics TRAM while the application program runs in parallel on the 
other compute TRAMs. An I SERVER runs on the host. 


3.1.1 ANSI C and Occam libraries 

The IMS F003C ANSI C and Occam interface libraries contain an equivalent set 
of procedures. They all communicate with the CGI display server over a pair of 
transputer channels connected between the server and application software. The 
programmer’s interface to the CGI system is defined by these interface libraries. 

The libraries contain two sets of procedures. Those prefixed by cgi_ belong to 
the family of Computer Graphics Interface primitives. There are a large number of 
these and collectively they define a two dimensional graphics package that is func- 
tionally conformant with a subset of the CGI standard. The CGI primitives are all 
device independent: they require no knowledge of the underlying graphics board 
architecture. 

The other set of procedures are prefixed by f s_. These implement a device inde- 
pendent interface to the graphics hardware. The same procedures are used to pro- 
gram the graphics hardware regardless of the actual graphics board being used. 
The CGI display server programs the hardware correctly by calling elements of a 
board specific support library which is selected according to the graphics board 
present. 


3.1.2 Graphics board support libraries 

The device independent interface to the graphics hardware provided by the CGI 
server is implemented by a number of device dependent board support libraries. 
Libraries are supplied for a wide range of the jq Systems graphics board products, 
the appropriate one is linked with the CGI display server when building an applica- 
tion. 

Monitor resolution and timing characteristics are completely programmable and 
the libraries also provide device independent colour palette setup and video 
memory management. 

The board support libraries are supplied in source code form. If required, a variant 
for some other transputer based graphics board can be created by porting the 
source provided. This is described in Chapter 10. 


72 OEK 264 01 


May 1992 


9 


4 CGI concepts 


IMS F003C provides a functionally conformant subset of the Computer Graphics 
Interface standard (ISO TC97/SC21 N1179). The standard defines the interface 
between the device independent and device dependent parts of a two dimensional 
(2D) graphics system. IMS F003C implements the CGI graphical primitive func- 
tions, attribute functions and miscellaneous initialisation and error logging primi- 
tives. 

CGI defines the functional behaviour of a number of graphical output primitives and 
attribute functions, in a way which is encoding and binding independent. This al- 
lows the same facilities to be provided in different languages while taking into ac- 
count the syntax of that language. IMS F003C provides such bindings for the ANSI 
C and Occam programming languages. 

CGI graphical primitive functions are those functions that define the geometric 
components of a picture. The graphics primitive functions defined in the CGI stan- 
dard fall into one of the following categories: 

• Line 

• Marker 

• Text 

• Filled area 

• Image 

• Generalised drawing primitive (GDP) 

CGI attribute functions determine the appearance of the graphical primitive func- 
tions. Attributes are either individual or ‘bundleable'. This means that either an at- 
tribute must be applied individually or that it may be combined with others, and then 
applied. 

Readers seeking further information on the CGI standard should consult docu- 
ment: ISO TC97/SC21 Nil 79. The following tables show how the various CGI 
primitives are implemented by the IMS F003C libraries. 
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Line functions 
Polyline 

Disjoint Polyline 
Circular Arc Centre 
Elliptical Arc 

cgi_ polyline 
cgi_disj polyline 
cgi_arc 
cgi_arc 

Marker function 
Poly Marker 

cgi_dot , cgi_copy 

Text functions 

Text 

Append Text 
Restricted Text 

cgi_text, cgi_sptext 
cgi__addtext , cgi_ addsptext 
cgi_text, cgi_sptext, cgi__chrbegin f 
cgi_chrspace 

Filled area 
functions 

Polygon 

Polygon Set 

Rectangle 

Circle 

Circular Arc 3 Point 
Close 

cgi_polygon, cgi_paint 

cgi_j?olyline, cgi_disj polyline, cgi_line, 
cgi_ftrap 

cgi_rect , cgi_f rect 

cgi_circle , cgi_f circle 

cgi_arcc, cgi__strokearc, cgi_fanfill 

Circular Arc Centre 
Close 

cgi__arcc, cgi_strokearc, cgi_fanfill 

Ellipse 

Elliptical Arc Close 

cgi — circle, cgi_f circle 

cgi_arcc, cgi_strokearc, cgi_fanfill 

Image function 

Cell Array 

cgi_frect, cgi_ftrap, cgi_copy 


Table 4.1 CGI graphical primitives vs. IMS F003C 
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Line attributes 

Line Type 

Line Width 

Line Colour 

cgi_setlinestyle, 

cgi_setdrawmode 

Marker attributes 

Marker Type 

Marker Size 

Marker Colour 

cgi_setpelstyle, cgi_copy, 
cgi_zoom 

Text attributes 

Text Font Index 

Text Precision 

Character Expansion Factor 

Character Spacing 

Text Colour 

Character Height 

Character Orientation 

Character Set Index 

cgi_setfont 

cgi_text, cgi_chrz, cgi_zoom 

cgi_chrz, cgi_zoom 

cgi_chrspace 

cgi_setfcol 

cgi__chrz 

cgi_setorient 

cgi_setfont 

Filled area attributes 

Interior Style 

Fill Colour 

Hatch Index 

Pattern Index 

Pattern Table 

Pattern Size 

cgi_setf illstyle, cgi_setfcol 


Table 4.2 CGI attribute primitives vs. IMS F003C 
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4.1 The IMS F003C CGI library 

The IMS F003C CGI functions are supplied in an INMOS TCOFF compatible object 
library called CGILIB . LIB. Two variants are provided, one for ANSI C, the other 
for Occam. The following lists summarise the CGI functions available: 


Line functions 
cgi_line 
cgi_rect 
cgi_polyline 
cgi_disj polyline 
cgi_polygon 
cgi_circle 
cgi__arc 
cgi_arcc 
cgi__s tr okear c 
cgi_dot 

cgi_s e t 1 i ne s ty 1 e 

Straight line 

Rectangle outline 

Consecutive line segments 

Straight line segments 

Polygon outline 

Ellipsoid outline 

Partial ellispoid outline 

Closed partial ellipsoid outline 

Stroke ellipsoid outline 

Single point 

Setup custom line style 

Text functions 
cgi__text 

cgi_addtext 

c 9 i_sptext 

cgi_addsptext 

cgi_chrbegin 

cgi_chrspace 

cgi_chrz 

cgi_setfont 

Print text at position 

Add text at current position 

Print text with spacing control 

Add text with spacing control 

Set character position 

Set character spacing 

Print character with scaling 

Setup character font 

Filled area functions 
cgi_cls 
cgi_frect 
cgi_fcircle 
cgi_fanf ill 
cgi_paint 
cgi_ftrap 
cgi_fhline 
cgi__se tf i 1 1 s ty le 

Clear screen 

Filled rectangle 

Filled ellipsoid 

Filled partial ellipsoid 

Area flood fill 

Filled trapezoid 

Filled horizontal lines 

Set custom fill pattern 
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Image functions 

cgi_copy 

Image copy 

cgi_zoom 

Image copy with zoom 

cgi_rot 

Image rotation 

cgi__shear 

Image shear 

cgi_search 

Search for colour change 

cgi_setpelstyle 

Set custom pel pattern 

Control functions 

cgi_init 

Initialise CGI system 

cgi_terminate 

Terminate CGI system 

eg i_s e tdr awmode 

Set drawing modes 

cgi_setdrawscreen 

Set current CGI screen 

cgi_setorient 

Set text and image orientation 

Error handling 

cgi_errstat 

Expound current CGI error 


4.2 Screens 

All CGI operations are performed on an abstract data structure called a screen. A 
screen represents a bounded two dimensional area that contains the graphical 
output of CGI functions. Cartesian coordinates are used to address points located 
on a screen and all CGI operations, when applied to a screen, are clipped to its 
extent. The CGI system uses the screen abstraction to represent various types of 
graphical object. For example, screens are used to hold character images when 
expanded from a packed font. 

In IMS F003C, the ANSI C and Occam implementations of a screen are defined 
as follows: 


ANSI C struct 

Occam int array 

struct 

{ 

char ^raster; 

[SCREEN. SIZE] INT screen: 

screen [ SCREEN .RASTER] 

int xsize; 

screen [SCREEN .XSIZE] 

int ysize; 

screen [ SCREEN .YSIZE ] 

int stride; 

screen [ SCREEN . STRIDE ] 

int multiMode; 

} screen; 

screen [SCREEN . MULTIMODE] 
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ras ter is the transputer address of a region of memory used to hold a two dimen- 
sional image, called a raster. It is xsize pixels wide by ysize pixels high. The 
stride value specifies the horizontal stride to take when stepping to an equivalent 
position on the next horizontal line. multiMode is used internally by the CGI sys- 
tem. 


x size 



Figure 4.1 The CGI screen abstraction 

The CGI system maintains the notion of a current drawing screen. This is a screen 
that has been identified as a target for future CGI operations: the majority of the 
CGI functions implicitly address the current drawing screen. It is assigned with 
cgi_setdrawscreen. 

Any number of screens may exist in a system and some may be related to others. 
For example, to build a windowing system one could use the screen abstraction 
to represent the hierarchies that exist between parent windows and their child sub- 
windows. The only restriction concerning the use of the screen abstraction is that 
the memory associated with a screen must be located on the transputer running 
the CGI display server. 

A screen may be displayed on an output monitor if its horizontal and vertical dimen- 
sions match the physical display resolution. Such a screen is referred to as a physi- 
cal screen. Physical screens are usually implemented with video memory on the 
graphics board. When displayed on a monitor their cartesian origin (0,0) is lo- 
cated at the top left hand corner of the display. 

CGI screens can be allocated statically, or dynamically, on the transputer that runs 
the CGI display server. A new screen may be derived from an existing one by refer- 
encing a sub-area of the existing screen’s raster memory. Physical screens are al- 
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located dynamically using f s_initscreen and have their rasters stored in video 
memory on the graphics board. 

4.3 Colour representation 

The IMS F003C implementation of CGI uses 8 bit pixels resulting in screens con- 
taining up to 256 different colours. Pixel values are used to address a colour palette 
which generates the actual display colour from a possibly larger range. The resolu- 
tion of the colour palette is graphics board dependent, see section 5.3 for specific 
details of this. 


4.4 CGI drawing modes 

The CGI system may operate in a number of different drawing modes that define 
the run-time behaviour of graphical primitives. Drawing modes are concerned with 
the following: 

• Plot style 

• Filler mode 

• Pixel replace mode 

Ultimately, most graphical primitives are implemented by plotting a sequence of 
pixels. The pixel replace mode defines how a pixel is written into screen memory. 
The plot style is used to control the generation of pixel values, for example, when 
drawing a line, and the fill mode relates to the different methods available for per- 
forming area flood fill. 

The CGI system applies the current plot style, fill and pixel replace modes implicitly, 
during normal operation. They may be initialised with cgi_setdrawmode and de- 
pending on the CGI function may combine to produce a resultant visual effect. In 
other situations only a subset may have an impact. 

4.4.1 Plot styles 

Plot styles affect the outcome of the CGI plotting and outline functions, such as 
cgi_dot, cgi_circle or cgi_j>olyline. 

When tracing the outline of an object, or when plotting a sequence of straight lines, 
the current plot style determines the size, shape and visibility of every point plotted. 
There are five plot styles: 

. PIXEL 

• PEL 

• LINESTYLE 
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• LINESTYLE-TRANSPARENT 

• LINESTYLE-PEL 


PIXEL 

A single pixel is plotted to represent each point. This gives solid outlines of mini- 
mum display thickness drawn in the current foreground colour. See cgi setf- 
col. 

PEL 

Each point is represented by a small, two dimensional pattern, called a pel. The 
pel pattern is established with cgi_setpelstyle and used whenever a point 
would otherwise have been plotted. Pels are useful for repeatedly plotting custo- 
mised shapes such as cursors or bullet marks. 

The pixel values defined by a pel pattern determine its colour. In the default pixel 
replace mode (overwrite) only pixels which have non-zero values are plotted. This 
means that if the pel background colour is always zero, then the foreground can 
consist of any number of non-zero colours, all of which will be plotted normally. By 
selecting an appropriate pixel replace mode the zero-valued background can be 
plotted, or the foreground ignored. 

LINESTYLE 

A line style is a one dimensional array of pixel values that is used to determine the 
value of consecutive points on a line. The CGI system keeps track of which pixel 
value to use for the next point and cycles repeatedly through the pixel array assign- 
ing values to new points. A pixel value can be used a variable number of times be- 
fore moving on to the next value, this is controlled by the line style zoom factor and 
achieves a stretch effect. Line styles are initialised with cgi_setlinestyle 
which defines the pixel anay contents, and its zoom factor. 

LINESTYLE-TRANSPARENT 

This is a variant of the line style. A transparency effect is achieved by only plotting 
points that have non-zero values as defined by the line style array. All other points 
are plotted normally. Zero valued pixels define positions where background 
colours will be visible through the line style. 

LINESTYLE-PEL 

Another variant of the line style mode, this combines a line style with a pel pattern. 
Non-zero valued points defined by the line style are replaced by the pel pattern. 

4.4.2 Filler modes 

The CGI area fill primitives operate according to the current fill mode. This defines 
the method for filling areas created by functions such as cgi_f rect or cgi fan- 
fill. There are two fill modes: “ “ 
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• SOLID 

• PATTERN 


SOLID 

Areas are filled with a solid colour. The colour is defined by the current foreground 
colour, see cgi_setfcol. 

PATTERN 

A customised two dimensional pattern called a fill style is used. This is tiled over 
the fill area and clipped to it‘s boundary. The current fill style is intialised with 
cgi_setf illstyle to define the pixel values contained in the fill style pattern. 
By selecting a suitable pixel replace mode, zero valued pixels may be treated spe- 
cially if required, otherwise they are written to the current screen along with the 
non-zero valued pixels. 

4.4.3 Pixel replace modes 

The pixel replace modes define how pixels are ultimately written into screen 
memory. They are fundamental to the operation of the CGI system: the result of 
every CGI primitive in conjunction with the higher level drawing modes is in- 
fluenced by the current pixel replace mode. There are three types of pixel replace 
mode: 

• OVERWRITE 

• LOGICAL 

• TRANSPUTER 
OVERWRITE 

The basic replace mode. Screen memory is overwritten with new pixel values. 

LOGICAL 

The logical replace modes are implemented by performing a read modify write op- 
eration on screen memory. An existing pixel is combined, using a logical operator, 
with the new pixel value and the resultant pixel written into screen memory. The 
logical modes supported are: 


Operator 

Result 

AND 

bitwise AND 

OR 

bitwise OR 

XOR 

bitwise XOR 

NAND 

bitwise NAND 

NOR 

bitiwse NOR 
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TRANSPUTER 

The transputer replace modes correspond directly to the two dimensional block 
move instructions supported by the transputer. They are: 


Operator 

Result 

MOVE2DALL 

MOVE2DZERO 

MOVE2DNONZERO 

block copy 

zero block copy 
non-zero block copy 
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5 Graphics board 
concepts 


The jq Systems graphics board products supported by IMS F003C all have a simi- 
lar hardware architecture. They all feature a transputer (of some sort), have normal 
dynamic random access memory for program and data storage and an additional 
area of special purpose video memory for image output to a graphics monitor. All 
the boards have a colour video controller (CVC) chip capable of driving a wide 
range of monitors at different pixel rates and at different display resolutions. 

The IMS F003C CGI library contains a number of functions for initialising and con- 
trolling the hardware on a graphics board in a device independent way. This allows 
software developed for one graphics board to run on another without changing any 
source code. The programmer’s interface to the graphics board hardware is de- 
fined by the following functions: 


Function 

Description 

fs_screenaddr 

f s_di sp 1 aybank 

fs__initscreen 

fs__setpalette 

fs__°penb°ard 

fs_closeboard 

fs_writeregs 

Return the address of a screen’s raster 

Display a bank of video memory 

Map a physical screen to video memory 

Set colour palette entry 

Device independent board open function 
Device independent board close function 
Write graphics board registers 


These functions cause the CGI display server to call a similar set of functions from 
a device dependent library that achieve an equivalent effect on whatever graphics 
hardware is actually present. The CGI server is linked against a device dependent 
library when building an application program for a particular graphics board. De- 
vice dependent libraries for the following /q Systems graphics board products are 
provided with IMS F003C: 


rq Systems graphics board 

IMS F003C library 

IMS B419 graphics TRAM 

B419.LIB 

IMS B419 graphics TRAM with G300A 

B419A.LIB 

IMS B437 compact display TRAM 

B437.LIB 
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5.1 Board initialisation 

In order to use a graphics board an application must first open it with the f s_open- 
board function. This performs a number of operations to initialise the graphics 
hardware ready for use by the CGI system. The most important of these is the intial- 
isation of the CVC chip. The CVC chip generates a display on an output monitor 
and must be programmed with a number of video timing parameters that specify 
the format and timing of signals used to control the monitor. Usually, this will de- 
pend on the desired display resolution and the timing characteristics of the chosen 
monitor. 

The CVC is programmed with the contents of a data structure called the video tim- 
ing generator (abbreviated VTG) parameter block. This contains a number of val- 
ues that define elements of the video signals used to drive a monitor. The parame- 
ters are directly applicable to a range of CVC devices manufactured by INMOS and 
used on the iq Systems graphics boards. The ANSI C and Occam definitions of 
the VTG parameter block are: 


ANSI C struct 

Occam int array 

struct 

{ 

int pll ; 

[VTG. SIZE] INT vtg: 

vtg [VTG. PLL] 

int line_time; 

vtg [VTG . LINE . TIME] 

int half_sync; 

vtg [VTG . HALF . SYNC ] 

int backjporch; 

vtg [VTG . BACK . PORCH] 

int display; 

vtg [VTG. DISPLAY] 

int short_di splay ; 

vtg [VTG . SHORT . DISPLAY] 

int v_display; 

vtg [ VTG. V. DISPLAY] 

int v_blank; 

vtg [ VTG. V. BLANK] 

int v_sync; 

vtg [ VTG. V. SYNC] 

int v_preequalise ; 

vtg [VTG .V. PREEQUALISE] 

int v_postequalise; 

vtg [VTG . V. POSTEQUALISE] 

int broad_pulse ; 

vtg [VTG . BROAD . PULSE] 

int mem__init; 

vtg [VTG. MEM. INIT] 

int transfer_delay ; 

vtg [VTG . TRANSFER . DELAY] 

int mask_register ; 

vtg [VTG . MASK . REGISTER] 

int control; 

} vtg; 

vtg [VTG. CONTROL] 


ANSI C and Occam header files are supplied that define a number of constant 
VTG parameter blocks suitable for controlling a range of monitors at a number of 
commonly used display resolutions. In most situations, a parameter block that 
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matches the requirements of a particular application can be selected from the 
header file and used verbatim. If a suitable parameter block can’t be found, or if 
special requirements dictate the use of other timing parameters, then consult The 
graphics databook [5]. 

This contains technical information about INMOS CVC devices. It includes an in 
depth discussion of video timing mechanisms and how to calculate video timing 
parameters. The reader should also consult the appendices, which contain engi- 
neering data for the jq Systems graphics board products supported by IMS F003C. 


5.2 Video memory management 

Transputers used on the /q Systems graphics boards have a linear address space. 
Within this space lies a region of normal dynamic random access memory (DRAM) 
and a region of special video memory (VRAM). The size and location of these 
memory areas is dependent on the architecture of the graphics board. The DRAM 
is always located at the bottom of the transputer address map (most negative ad- 
dress end) and is used for program and data storage. The VRAM is located else- 
where, usually at higher addresses, and is used as raster memory to store the out- 
put of graphical operations. A monitor display is produced by the CVC which reads 
the VRAM continuously to generate the appropriate output signals. 

On some graphics boards the two memory areas are separate, on others they may 
be configured (with a jumper) to be either contiguous or non-contiguous. Spare vid- 
eo memory can be used for additional program and data storage, but only if it is 
contiguous with existing DRAM. Other boards have no normal DRAM at all and use 
VRAM for program, data and raster storage. The amount of VRAM required to gen- 
erate output on a monitor is directly related to the monitor resolution. Since the 
CVC hardware allows this to be configured at run-time the available VRAM can 
serve a number of purposes: 

• Depending on the amount of VRAM present it can be used to store a num- 
ber of monitor sized rasters. The graphics hardware is programmed to dis- 
play one of these rasters but can be switched, at any time, to display anoth- 
er. 


• If the VRAM is contiguous with DRAM then part of it may be allocated to 
program storage effectively extending the amount of the DRAM available. 

Video memory is managed by dividing it up into a number of equal sized regions, 
called banks. The size of a bank is determined by the display resolution and 
matches exactly the amount of raster memory needed to generate an output image 
at that resolution. The total number of video banks available on a particular graph- 
ics board therefore depends on two factors: the amount of VRAM present and the 
configured display resolution. 
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The memory architecture of a typical graphics board is shown in the diagram be- 
low: 


VRAM 



J Output to a monitor 


Program and data 


Figure 5.1 Memory architecture of a graphics board 


Note that video memory banks are allocated from the top of video memory toward 
lower memory addresses. In the diagram, bank number 0 is positioned at the top 
most part of VRAM. Other banks are located at ever decreasing addresses be- 
neath this. If the VRAM and DRAM are contiguous it is possible to extend the 
memory available for program and data storage by using up spare VRAM banks 
near the bottom. This is achieved by configuring an application program with a 
memory size that includes any spare VRAM banks nominated for program use. It 
is the programmer’s responsibility to ensure that such VRAM banks will never be 
used for any other purpose. 


5.2.1 Mapping physical CGI screens to VRAM 

Physical CGI screens have theirraster memory allocated from VRAM by initialising 
a screen data structure to reference a video memory bank. This is done with 
f s_initscreen, given the number of the video memory bank to use for the 
screen’s raster it returns a screen structure. 

There need be no correspondence between the current CGI drawing screen and 
the physical screen displayed on a monitor. Both can be selected independently. 
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A screen is made visible by programming the graphics hardware to output the cor- 
responding video memory bank, f s__displaybank does this. 

In the example below, a new screen is allocated and mapped to video memory 
bank 0. It is made the current CGI drawing screen and its video memory bank dis- 
played on an output monitor. This has the effect of causing the CGI system to dis- 
play all subsequent operations instantaneously, on the monitor. 

{ 

screen s ; 

/* Allocate a physical screen and map it to bank 0 */ 

f s_initscreen ( from__cgi, to__ cgi, &s , 0 ); 

/* The screen is s.xsize pixels wide by s.ysize pixels 

high. These values correspond to the monitor resolution 
which is fixed at startup time with f s_openboard ( ) */ 

/* Assign the screen to the current draw screen */ 

cgi_setdrawscreen ( to_cgi, s ); 

/* Display the screen on an output monitor */ 

f s_displaybank ( to__cgi, 0 ); /* Output video bank 0 */ 

/* Do lots of drawing with the CGI functions ... */ 

5.3 Colour palette 

The INMOS colour video controller chips used on all the iq Systems graphics board 
products generate colour displays with a programmable colour look-up table 
called a palette. This provides a mapping between pixel values and the actual co- 
lour generated on an output monitor. Colour values are described by three num- 
bers that specify the red, green and blue components of the colour. For a given pix- 
el value, the output colour is programmed with f s__setpalette by specifying 
what the red, green and blue colour components should be. 

The colour components have an 8 bit resolution. When combined, they describe 
a colour from a 24 bit colourspace that supports a palette of up to 16 million differ- 
ent colours. Because the IMS F003C CGI system manipulates 8 bit pixel values 
the colour palette can contains up to 256 different colours selected from the 16 mil- 
lion possible. 


5.4 The iq Systems graphics boards 

This section describes some specific features of iq Systems graphics boards that 
should be considered before using them. More detailed engineering data, on each, 
can be found in the appendices. 
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5.4.1 IMS B419 graphics TRAM 

The IMS B419 has 2M bytes of DRAM and 2M bytes of VRAM. There is enough 
video memory to support display resolutions of up to 1280 by 1024 pixels with 
some left over. (Note that display resolutions any larger than this are not possible 
because of the very high pixel data rates required). 

There are two variants of the IMS B419. The older has an IMS G300A CVC fitted, 
current production versions use the IMS G300B. The corresponding board support 
libraries are: B4 1 9A . LIB and B4 1 9 . LIB. 

The IMS B419 must be configured to make its DRAM and VRAM contiguous. This 
is a jumper option on the board and is described in Appendix B. Making the memory 
areas contiguous offers the possibility to extend program and data space into 
VRAM as previously described. Note that the board support libraries will not func- 
tion correctly unless this is done. 


5.4.2 IMS B437 compact display TRAM 

The IMS B437 has 1M byte of VRAM and no DRAM. Because of the limited 
memory available a trade off situation must be reached to satisfy the requirements 
of program storage and the desired monitor resolution. For example, one screen 
with a resolution of 1024 by 768 pixels would leave approximately 256K bytes of 
memory left for program storage. Typically, the IMS B437 is used in configurations 
where only the CGI server runs on the IMS B437 and application software runs 
elsewhere in the transputer network. 

The board support library for the IMS B437 is: B437.LIB. 

The special purpose times one pixel clock frequencies available on the IMS B437 
are not used by the board support library. For more information on these features 
see the Appendix C. 
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6 CGI libraries 

6.1 Initialisation and termination 

6.1.1 cgijnit 
Initialise the CGI server. 

C: 

void cgi_init( Channel *to_cgi ) 

occam: 

PROC cgi.init( CHAN OF ANY to.cgi ) 
Parameters: 


Parameter 

Comment 

to_cgi 

Channel to CGI server 


Description: 

cgi_init initialises the CGI system to the following state: 

• No current text font 

• No current pel, fill or line style patterns 

• Pixel mode PM_COL 

• Replace mode RM_COL 

• Fill mode fm_col 

6.1.2 cgi_terminate 
Terminate the CGI display server. 

C: 

void cgi_terminate ( Channel *from__cgi, Channel *to_cgi ) 

occam: 

PROC cgi . terminate ( CHAN OF ANY from.cgi, to.cgi ) 
Parameters: 


Parameter 

Comment 

from_cgi 

to_cgi 

Channel from CGI server 

Channel to CGI server 


Description: 

cgi_ terminate terminates the CGI display server. 
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6.2 Alphabetical list of CGI primitives 


6.2.1 cgi_addsptext 

Append text at current character position, with spacing control. 


void cgi_addsptext ( 
Channel * to_cgi , 
int n, char *str, 
int *dx, int *dy ) 

occam: 

PROC cgi . addsptext ( 
CHAN OF ANY to. cgi, 
VAL INT n, 

VAL [ ] BYTE str, 

VAL [ ] INT dx, dy ) 

Parameters: 


Parameter 

Comment 

to_cgi 

Channel to CGI server 

n 

Number of characters to plot 

str 

Character string 

dx 

X axis character spacing distances 

dy 

Y axis character spacing distances 


Description: 

cgi_addsptext plots n characters from the character string str according to 
the current font description. The first character is plotted at the current character 
position which is then incremented by X and Y axis offsets specified by the inter- 
character spacing vectors dx and dy, for the character. Subsequent characters are 
plotted in the same manner, using the next pair of spacing distances. The current 
character position after the operation completes is offset from the first character 
plotted by X and Y axis distances equal to the sum of the dx and dy spacing vectors 
respectively. 

The spacing vectors should be set with respect to the current orientation, see 
cgi_setorient. Characters are plotted according to the current pixel replace 
mode, see cgi_setdrawmode. 

Characters are reproduced at the size of theirfont, which should be initialised, see 
cgi_setfont. Each pixel of every character plotted is clipped to the current 
screen definition, see cgi_setdrawscreen. 
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For text display, the default pixel replace mode rm_COL, will cause characters to 
imprint within a rectangular bounding box of colour 0. In some cases this will not 
produce the desired effect. If only the foreground of the text is required and a pixel 
overwrite mode rather than a logical operation is desired then select pixel replace 
mode rm_nz. This will cause only those pixels which are non-zero to be plotted. 


Diagram: 
Current screen 

r 
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6.2.2 cgi_addtext 

Append text at current character position. 


void cgi_addtext( 
Channe 1 * to_cgi , 
int n, char *str ) 

Occam: 

PROC cgi. add text ( 
CHAN OF ANY to. cgi, 
VAL INT n, 

VAL [ ] BYTE str ) 

Parameters: 


Parameter 

Comment 

to_cgi 

n 

str 

Channel to CGI server 

Number of characters to plot 

Character string 


Description: 

cgi__addtext plots n characters from the character string str according to the 
current font description. Characters are plotted at the current character position 
which is then incremented by the currently defined X and Y axis inter-character 
spacing distances, see cgi_chr space. The current character position after the 
operation completes is offset from the last character plotted by these distances. 

Characters are plotted according to the current pixel replace mode, see cgi_set- 
drawmode and the current orientation, see cgi__setorient. 

Characters are reproduced at the size of their font which should be initialised, see 
cgi_setfont. Each pixel of every character plotted is clipped to the current 
screen definition, see cgi_setdrawscreen. 

For text display, the default pixel replace mode RM_COL, will cause characters to 
imprint within a rectangular bounding box of colour 0. In some cases this will not 
produce the desired effect. If only the foreground of the text is required and a pixel 
overwrite mode rather than a logical operation is desired then select pixel replace 
mode RM__nz. This will cause only those pixels which are non-zero to be plotted. 
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Diagram: 


Current screen 
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6.2.3 cgi_arc 

Outline part of an axis aligned ellipsoid. 


void cgi_arc( 

Channel *to_cgi, 

int Xc, int Yc, int A, int B, 

int DXs f int DYs, int DXe, int DYe ) 

Occam: 

PROC cgi.arc( 

CHAN OF ANY to.cgi, 

VAL INT Xc, Yc, A, B, DXs, DYs, DXe, DYe ) 
Parameters: 


Parameter 

Comment 

to_cgi 

Channel to CGI server 

(Xc, Yc) 

Centre coordinate 

A 

Length of X direction semi axis 

B 

Length of Y direction semi axis 

(DXs, DYs) 

Start vector 

(DXe, DYe) 

End vector 


Description: 

cgi_arc plots part of the outline of an axis aligned ellipsoid centred at (Xc, Yc) 
and with semi-axis lengths of A and B pixels. Both A and B must be positive, the 
larger of the two values is the semi-major axis length, while the lesser specifies the 
semi-minor axis length. 

(DXs, DYs) and (DXe, DYe) define direction vectors eminating from the centre 
of the ellipse that specify which part of its outline to draw. Only points clockwise of 
the (DXs, DYs) vector and anti clockwise of (DXe, DYe) are plotted. 

The outline is clipped to the current screen definition, see cgi_setdrawscreen. 

The current pixel replace and plot modes affect the appearance of the outline, see 
cgi_s e tdr a wmode . 
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Diagram: 
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6.2.4 cgi_arcc 

Outline part of an axis aligned ellipsoid, closed with chord or segment lines. 

C: 

void cgi_arec( 

Channel *to_cgi, 

int Xc, int Yc, int A, int B, 

int DXs , int DYs, int DXe, int DYe, 

int CloseMode ) 

Occam: 

PROC cgi.arcc( 

CHAN OF ANY to.cgi, 

VAL INT. Xc, Yc, A, B, DXs, DYs, DXe, DYe, 

CloseMode ) 

Parameters: 


Parameter 

Comment 

to_cgi 

Channel to CGI server 

(Xc, Yc) 

Centre coordinate 

A 

Length of X direction semi axis 

B 

Length of Y direction semi axis 

(DXs, DYs) 

Start vector 

(DXe, DYe) 

End vector 

CloseMode 

Close mode 


Description: 

cgi_arcc plots part of the outline of an axis aligned ellipsoid centred at (Xc , Yc) 
and with semi-axis lengths of A and B pixels. Both A and B must be positive, the 
larger of the two values is the semi-major axis length, while the lesser specifies the 
semi-minor axis length. 

(DXs, DYs) and (DXe, DYe) define direction vectors eminating from the centre 
of the ellipse that specify which part of its outline to draw. Only points clockwise of 
the (DXs, DYs) vector and anti clockwise of (DXe, DYe) are plotted. 

The partial outline is closed with either a single chord line, joining the two end 
points, or a pair of segment lines, connecting each end point to the centre of the 
ellipse at (Xc , Yc) . The value of CloseMode determines which method is used, 
valid values are: 


72 OEK 264 01 


May 1992 


IMS F003C 2D graphics Occam and C libraries 


33 


CloseMode 

Comment 

CM_CHORD 

CM_SEGMENT 

Close outline with a chord line 

Close outline with two segment lines 


The outline is clipped to the current screen definition, see cgi_setdrawscreen. 

The current pixel replace and plot modes affect the appearance of the outline, see 
cgi__se tdr awmode . 


Diagram: 
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6.2.5 cgi_chrbegin 

Set current character display position. 

C: 

void cgi_chrbegin ( 

Channel *to_cgi, 
int X, int Y ) 

Occam: 

PROC cgi . chrbegin ( 

CHAN OF ANY to. cgi, 

VAL INT X, Y ) 

Parameters: 


Parameter 

Comment 

to_cgi 

(X,Y) 

Channel to CGI server 

Character position coordinate 


Description: 

cgi_chrbegin sets the current character position to (X , Y) . The next text opera- 
tion will start plotting characters at this position. All text operations, other than 
c 9i_ c h rz » update the current character position as characters are plotted. 

Setting the current character position to a location outside the extent of the current 
screen definition is allowed. However, it should be remembered that all character 
plotting operations are clipped to the current screen definition, see cgi set- 
drawscreen. “ - 
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6.2.6 cgi_chrspace 

Set current inter-character spacing. 

C: 

void cgi_chrspace ( 

Channel *to_cgi, 
int dX, int dY ) 

Occam: 

PROC cgi . chrspace ( 

CHAN OF ANY to. cgi, 

VAL INT dX, dY ) 

Parameters: 


Parameter 

Comment 

to_cgi 

dX 

dY 

Channel to CGI server 

X axis character spacing distance 

Y axis character spacing distance 


Description: 

cgi_chrspace sets the current inter-character spacing distances. These values 
are used to increment the current character position, in the X and Y axis directions, 
after each character is plotted, dx specifies the inter-character spacing distance 
in the X axis direction, dY specifies the Y axis distance. 

The inter-character spacing is independent of the current orientation and font size, 
see cgi_setorient and cgi_setfont. 
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6.2.7 cgi_chrz 

Plot character with zoom scaling. 

C: 

void cgi_chrz( 

Channel *to__cgi, 
char ch, 

int zlenx, int zleny ) 

Occam: 

PROC cgi . chrz ( 

CHAN OF ANY to. cgi, 

VAL BYTE ch, 

VAL INT zlenx, zleny ) 

Parameters: 


Parameter 

Comment 

to_cgi 

Channel to CGI server 

ch 

Character to plot 

zlenx 

Width of scaled character on X axis 

zleny 

Height of scaled character on Y axis 


Description: 

cgi_chrz plots the single character ch according to the current font description 
and with independent scaling in the X and Y axis directions, zlenx specifies the 
width of the character, when plotted, in the X axis direction. The character’s height, 
also when plotted, is given by zleny on the Y axis. 

Depending on the current font size, see cgi_setfont, reduction or enlargement 
can be achieved independently in the X and Y axis directions by setting zlenx and 
zleny appropriately. 

The current character position is NOT updated after the character is plotted. 

The character is plotted according to the current pixel replace mode, see 
cgi__se tdrawmode . 

For text display, the default pixel replace mode rm_col, will cause the character 
to imprint within a rectangular bounding box of colour 0. In some cases this will not 
produce the desired effect. If only the foreground of the character is required and 
a pixel overwrite mode rather than a logical operation is desired then select pixel 
replace mode rm_nz. This will cause only those pixels which are non-zero to be 
plotted. 

Each pixel of the character plotted is clipped to the current screen definition, see 
cgi_setdrawscreen. 
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6.2.8 cgi_circle 

Outline an axis aligned ellipsoid. 

C: 

void cgi_circle( 

Channel *to_cgi, 

int Xc, int Yc, int A, int B ) 

Occam: 

PROC cgi. circle( 

CHAN OF ANY to.cgi, 

VAL INT Xc, Yc, A, B ) 

Parameters: 


Parameter 

Comment 

to_cgi 

Channel to CGI server 

(Xc, Yc) 

Centre coordinate 

A 

Length of X direction semi axis 

B 

Length of Y direction semi axis 


Description: 

cgi_circle plots the outline of an axis aligned ellipsoid centred at (Xc, Yc) and 
with semi-axis lengths of A and B pixels. Both A and B must be positive, the larger 
of the two values is the semi-major axis length, while the lesser specifies the semi- 
minor axis length. An outline of a circle is plotted with a diameter equal to either 
A or B, if they have identical values. 

The outline is clipped to the current screen definition, see cgi_setdrawscreen. 
The current pixel replace and plot modes affect the appearance of the outline, see 

cgi_se tdr awmode . 
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Diagram: 


Current screen 



A > B 

A = Semi Major Axis 
B = Semi Minor Axis 
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6.2.9 cgi_cls 

Clear screen. 

C: 

void cgi_cls ( 

Channel *to_cgi, 
screen s, int colour ) 

Occam: 

PROC cgi.cls( 

CHAN OF ANY to.cgi, 

VAL [SCREEN. SIZE] INT s, 
VAL INT colour ) 

Parameters: 


Parameter 

Comment 

to_cgi 

s 

colour 

Channel to CGI server 

Screen to clear 

Colour 


Description: 

cgi_cls clears the entire raster area associated with the screen s to the colour 

specified by colour. 

The current fill and pixel replace modes are ignored. 
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6.2.10 cgi_copy 

2D region block copy. 

C: 

void cgi_copy( 

Channel *to_cgi, 

screen s, int Xs, int Ys, 

int DX, int DY, 

screen d, int Xd, int Yd ) 

Occam: 

PROC cgi.copy( 

CHAN OF ANY to.cgi, 

VAL [SCREEN. SIZE] INT s, 
VAL INT Xs, Ys, DX, DY, 
VAL [SCREEN. SIZE] INT d, 

VAL INT Xd, Yd ) 

Parameters: 


Parameter 

Comment 

to_cgi 

Channel to CGI server 

s 

Source screen 

(Xs , Ys) 

Source coordinate 

DX 

Size of region in X direction 

DY 

Size of region in Y direction 

d 

Destination screen 

(Xd, Yd) 

Destination coordinate 


Description: 

cgi_copy copies a rectangular, axis aligned, region from the source screen s to 
the destination screen d. The size of the region is specified by DX pixels in the X 
axis direction and DY pixels on the Y axis. 

The coordinate (Xs,Ys) identifies the top left hand corner of the region on the 
source screen, it is copied to (Xd, Yd) on the destination screen. 

The region is clipped to the destination screen definition. No scaling is performed. 

The current orientation and pixel replace modes affect the resultant display, see 
cgi_setorient and cgi__setdrawmode. 
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Diagram: 

Source screen s 



Destination screen d 
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6.2.11 cgi_disjpolyline 

Draw a sequence of disjoint lines. 

C: 

void cgi_dis jpolyline ( 
Channel *to__cgi, 
int n, int ^points ) 

Occam: 

PROC cgi .dis jpolyline ( 
CHAN OF ANY to. cgi, 

VAL INT n, 

VAL [ ] INT points ) 

Parameters: 


Parameter 

Comment 

to_cgi 

n 

points 

Channel to CGI server 

Number of (X,Y) points 

Line start and end points 


Description: 

cgi_dis jpolyline draws a sequence of disjoint (unconnected) straight lines 
between points defined by the integer vector points. The coordinate of a point 
is given by an integer pair (X,Y) and lines are drawn between a pair of coordinates 
specifying the line’s start and end points. Each coordinate is used only once, as 
either a line start or as an end point. The first coordinate contained in points is 
always treated as a line start point and the next its corresponding end point. The 
number of points is given by n which will usually be even (because a line is de- 
scribed by two points). If n is odd a single point is plotted instead of the last line, 
if it is 1 only a single point is plotted. 

Each line is clipped to the current screen definition, see cgi_setdrawscreen. 

The current pixel replace and plot modes affect the appearance of each line, see 
cgi__se tdr awmode . 
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Diagram: 
Current screen 
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6.2.12 cgi_dot 
Plot a point. 

C: 

void cgi_dot( 

Channe 1 * to_cgi , 
int X, int Y ) 

Occam: 

PROC cgi . dot ( 

CHAN OF ANY to. cgi, 
VAL INT X, Y ) 

Parameters: 


Parameter 

Comment 

t°__cgi 

(X,Y) 

Channel to CGI server 

Coordinate of point 


Description: 

cgi_dot plots a single point at (X, Y) . 

The point is only plotted if it lies within the extent of the current screen definition, 
see cgi_setdrawscreen. 

The current pixel replace and plot modes affect the appearance of the point, see 
cgi_setdrawmode. 

Diagram: 

Current screen 
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6.2.13 cgi_errstat 
Expound the current CGI error. 

C: 

int cgi_errstat( 

Channel *from_cgi, Channel *to_cgi, 
char *errtext, int *errqual ) 

Occam: 

PROC cgi.errstat( 

CHAN OF ANY from.cgi, to.cgi, 

[ ] BYTE err text, 

INT errtext.len, 

INT errno, errqual ) 

Parameters: 


Parameter 

Comment 

from_cgi 

to_cgi 

errtext 

errtext.len 

errno 

errqual 

Channel from CGI server 

Channel to CGI server 

Text string indicating error 

Length of error string (OCCAM only) 
CGI error code (OCCAM only) 

CGI error qualifier 


Note that cgi_errstat returns errno. 

Description: 

cgi__errstat returns the current CGI error status. 

The CGI system records the reason for any error condition it encounters during 
normal operation, this consists of an error code and an error qualifier. 

The error code errno indicates the reason for the current error and the qualifier 
errqual further qualifies it in a context sensitive way. For example, if the current 
error code describes an invalid pixel replace mode then the error qualifier will con- 
tain the offending mode value. 

A textual description of the current error code is returned in errtext, this should 
contain at least maxErrString characters of storage. For OCCAM, cgi . err- 
stat returns the length of the error string in errtext . len. The C variant returns 
a normal, null terminated, string. 
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The valid error number codes are: 


errno 

Comment 

e_OK 

No error 

eJBADPELMODE 

Invalid pixel plot mode, see cgi_set- 
drawmode 

e_BADRE PMODE 

Invalid pixel replace mode, see cgi_set- 
drawmode 

eJBADFILLMODE 

Invalid fill mode, see cgi_setdrawmode 

e_BAD SEARCHD I RN 

Invalid search direction, see cgi_search 

e_BADSEARCHTEST 

Invalid search test criteria, see 
cgi_search 

e__BAD FORIMODE 

Invalid orientation, see cgi setorient 


The current error code and qualifier will be reset to indicate "No error”. 
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6.2.14 cgi_fcircle 

Plot a filled, axis aligned, ellipsoid. 


void cgi_f circle ( 

Channel *to_cgi, 

int Xc, int Yc, int A, int B ) 

Occam: 

PROC cgi.f circle( 

CHAN OF ANY to.cgi, 

VAL INT Xc, Yc, A, B ) 

Parameters: 


Parameter 

Comment 

to_cgi 

Channel to CGI server 

(Xc, Yc) 

Centre coordinate 

A 

Length of X direction semi axis 

B 

Length of Y direction semi axis 


Description: 

egi_€eirelo plots a filled, axis aligned, ellipsoid centred at (Xe, Yc) and with 
semi-axis lengths of A and B pixels. Both A and B must be positive, the larger of 
the two values is the semi-major axis length, while the lesser specifies the 
semi-minor axis length. A filled circle is plotted with a diameter equal to either A or 
B, if they have identical values. 

Every point plotted is clipped to the current screen definition, see cgi_set- 
drawscreen. 

The current pixel replace and fill modes affect the appearance of the ellipse, see 
cgi_setdrawmode. 
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Diagram: 

Current screen 

r \ 



A > B 

A = Semi Major Axis 
v B = Semi Minor Axis 
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6.2.15 cgi_fanfill 

Plot a partially filled, axis aligned, ellipsoid. Closed with chord or segment lines. 

C: 

void cgi_f anf ill ( 

Channel *to_cgi, 

int Xc, int Yc, int A, int B, 

int DXs , int DYs, int DXe, int DYe, 

int CloseMode ) 

Occam: 

PROC cgi.fanfill( 

CHAN OF ANY to.cgi, 

VAL INT Xc, Yc, A, B, DXs, DYs, DXe, DYe, 

CloseMode ) 

Parameters: 


Parameter 

Comment 

t°__cgi 

Channel to CGI server 

(Xc, Yc) 

Centre coordinate 

A 

Length of X direction semi axis 

B 

Length of Y direction semi axis 

(DXs, DYs) 

Start vector 

(DXe, DYe) 

End vector 

CloseMode 

Close mode 


Description: 

cgi_f anf ill plots part of a filled, axis aligned, ellipsoid centred at (Xc , Yc) and 
with semi-axis lengths of A and B pixels. Both A and B must be positive, the larger 
of the two values is the semi-major axis length, while the lesser specifies the semi- 
minor axis length. 

(DXs , DYs) and (DXe, DYe) define direction vectors eminating from the centre 
of the ellipse that specify which part of its interior to fill. Only points clockwise of 
the (DXs, DYs) vector and anti clockwise of (DXe ,DYe) are plotted. 

The partial ellipse is bounded by either a single chord line, joining the two end 
points, or a pair of segment lines connecting each end point to the centre of the 
ellipse at (Xc , Yc) . The value of CloseMode determines which method is used, 
valid values are: 


CloseMode 

Comment 

CM_CHORD 

CM_SEGMENT 

Close ellipsoid with a chord line 

Close ellipsoid with two segment lines 
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Every point plotted is clipped to the current screen definition, see cgi_set- 
drawscreen. 

The current pixel replace and fill modes affect the appearance of the ellipse, see 
cgi_s e tdr awmode . 

Diagram: 

Current screen 
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6.2.16 cgi_fhline 

Plot a sequence of filled, horizontal, line segments. 

C: 

void cgi_fhline( 

Channel *to_cgi , 

int Y, int n, int *Xords ) 

Occam: 

PROC cgi.fhline( 

CHAN OF ANY to.cgi, 

VAL INT Y, n, 

VAL [ ] INT Xords ) 

Parameters: 


Parameter 

Comment 

to_egi 

Channel to CGI server 

Y 

Line segment Y ordinate 

n 

Number of X ordinates 

Xords 

Segment start and end X ordinates 


Description: 

cgi_fhline plots a sequence of filled horizontal line segments between points 
defined by the integer vector Xords in conjunction with the single Y axis ordinate 
Y. The coordinate of a point is given by an integer pair (X.Y) and lines are filled be- 
tween a pair of coordinates specifying the line’s start and end points on the horizon- 
tal line Y. Each coordinate is used only once, as either a line start or as an end point. 
When combined with Y, the first X axis ordinate contained in Xords is always 
treated as a line start point and the next value used to define its corresponding end 
point. The number of X axis ordinates is given by n which must be even (because 
a line is described by two points). 

Every line filled is clipped to the current screen definition, see cgi_setdraws- 
creen. 

The current pixel replace and fill modes affect the appearance of each line, see 
cgi_ s e tdr awmode . 
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Diagram: 


Current screen 
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6.2.17 cgi_frect 

Plot a filled, axis aligned, rectangle. 

C: 

void cgi_frect( 

Channel *to_cgi, 

int XO, int YO, int XI, int Y1 ) 

Occam: 

PROC cgi.frect( 

CHAN OF ANY to.cgi, 

VAL INT XO, YO, XI, Y1 ) 

Parameters: 


Parameter 

Comment 

to_cgi 

(X0,Y0) 

(XI, Yl) 

Channel to CGI server 

Corner point coordinate 

Opposite point coordinate 


Description: 

cgi_frect plots a filled, axis aligned, rectangle between two diagonally opposite 
points specified by the coordinates (XO , YO) and (XI , Yl) . 

Every point plotted is clipped to the current screen definition, see cgi_set- 
drawscreen. 

The current pixel replace and fill modes affect the appearance of the rectangle, see 
cgi_se tdr awmode . 

Diagram: 
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Current screen 
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6.2.18 cgi_ftrap 
Plot a filled trapezoid. 


void cgi_ftrap( 

Channel *to_cgi, 
int XI, int Yl, int X2, int Y2, 
int X3, int Y3, int X4 , int Y4 , 
int Ys, int Ye ) 

occam: 

PROC cgi . f trap ( 

CHAN OF ANY to. cgi, 

VAL INT XI, Yl, X2 , Y2, X3, Y3, X4, Y4, Ys, Ye ) 
Parameters: 


Parameter 

Comment 

to_cgi 
(XI, Yl) 

(X2,Y2) 

(X3,Y3) 

<X4,Y4) 

Ys 

Ye 

Channel to CGI server 

First edge: Start point coordinate 

First edge: End point coordinate 

Second edge: Start point coordinate 
Second edge: End point coordinate 

Top horizontal Y axis bound 

Bottom horizontal Y axis bound 


Description: 

cgi_f trap plots a filled trapezoid. The trapezoid is horizontally bounded by two 
non-horizontal edges, filling occurs between the left and right edge lines. The first 
edge is specified by a straight line between the points (XI, Yl) and (X2,Y2) and 
the second edge by a line between (X3,Y3) and (X4,Y4) .The fill area is vertical- 
ly bounded by two horizontal edges. The top edge is described by a horizontal line 
with a Y axis value equal to the larger of Ys and the smallest Yl, Y2, Y3 or Y4 ordi- 
nate. The bottom edge line has a Y axis value equal to the lesser of Ye and the 
largest Yl, Y2, Y3 or Y4 ordinate. 

The left and right edge lines may intersect. If they do, an object similar in shape 
to an hour glass (two touching triangles) will be plotted. 

Every point plotted is clipped to the current screen definition, see cgi_set- 
drawscreen. 

The current pixel replace and fill modes affect the appearance of the trapezoid, see 

cgi_s e tdr awmode . 
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Diagram: 

Current screen 

"\ 
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6.2.19 cgljine 

Draw a straight line between two points. 


void cgi__line( 

Channel *to_ cgi, 

int XO, int YO, int XI, int Y1 ) 

Occam: 

PROC cgi.line( 

CHAN OF ANY to. cgi, 

VAL INT XO, YO, XI, Y1 ) 

Parameters: 


Parameter 

Comment 

to_cgi 
(XO , YO) 

(XI, Yl) 

Channel to CGI server 

Start point coordinate 

End point coordinate 


Description: 

cgi_line plots a straight line between two points specified by the coordinates 
(XO , YO) and (Xl, Yl). 

Every point plotted is clipped to the current screen definition, see cgi_set- 
drawscreen. 

The current pixel replace and plot modes affect the appearance of the line, see 
eg i_s e t dr awmode . 

Diagram: 
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Current screen 
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6.2.20 cgi_paint 

Paint (flood fill) a bounded region. 

C: 

void cgi_paint( 

Channel *to_cgi, 

int Xs , int Ys, int Bcol ) 

Occam: 

PROC cgi. paint ( 

CHAN OF ANY to. cgi, 

VAL INT Xs, Ys, Bcol ) 

Parameters: 


Parameter 

Comment 

to_cgi 
(Xs , Ys) 

Bcol 

Channel to CGI server 

Interior point coordinate 

Boundary colour 


Description: 

cgi_paint flood fills a bounded region. The region is specified by a boundary of 
constant colour Bcol and filling starts at an interior point given by the coordinate 
(Xs , Ys ) . If the pixel at this point already has the value Bcol then no filling occurs. 

The current pixel replace and fill modes affect the resultant display, see cgi_set- 
drawmode. 

Filling with the current foreground colour (fill mode FM_COL and plot mode 
PM_COL) equal to the defined boundary colour produces a correct result. However, 
the use of a fill pattern which contains pixels of the boundary colour will almost cer- 
tainly fail. 

The fill algorithm guarantees correct behaviour when a logical pixel replace mode 
is active by plotting each pixel once only, see cgi_setdrawmode. 

The fill region is clipped to the current screen definition, see cgi_setdraws- 
creen. 
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Diagram: 
Current screen 
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6.2.21 cgi__polygon 

Outline a polygon. 

C: 

void cgi_polygon ( 
Channel *to_cgi , 
int n, int ^points ) 

Occam: 

PROC cgi. polygon ( 

CHAN OF ANY to. cgi, 
VAL INT n, 

VAL [ ] INT points ) 

Parameters: 


Parameter 

Comment 

t°_cgi 

n 

points 

Channel to CGI server 

Number of (X,Y) points 

Polygon vertex points 


Description: 

cgi_polygon plots the outline of a polygon by drawing a sequence of connected, 
straight lines, between its vertex points. The polygon’s last vertex point is con- 
nected to its first to complete the outline. The coordinate of each point is given by 
an integer pair (X,Y) taken from the vector points, the number of points is speci- 
fied by n. Lines are drawn in the order defined by each consecutive point contained 
in points. If only one coordinate is present, or if all the points are coincident, then 
a single point is plotted. 

The outline is clipped to the current screen definition, see cgi_setdrawscreen. 

The current pixel replace and plot modes affect the appearance of the outline, see 
cgi_s e tdr awmode . 
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Diagram: 
Current screen 
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6.2.22 cgi_polyline 

Draw a sequence of connected lines. 


void cgi_polyline ( 
Channel *to_cgi , 
int n, int *points ) 

occam: 

PROC cgi. polyline ( 
CHAN OF ANY to. cgi, 
VAL INT n, 

VAL [] INT points ) 

Parameters: 


Parameter 

Comment 

to_cgi 

n 

points 

Channel to CGI server 

Number of (X,Y) points 

Line start and end points 


Description: 

cgi_polyline draws a sequence of straight lines connecting the points defined 
by the integer vector points. The number of points is specified by n. The coordi- 
nate of a point is given by an integer pair (X,Y) and lines are drawn between a pair 
of coordinates specifying the line’s start and end points. The drawing order is de- 
fined by each consecutive point contained in points. The resulting, continuous 
line, is called a polyline. 

The polyline is clipped to the current screen definition, see cgi_setdrawscreen. 

The current pixel replace and plot modes affect the appearance of the polyline, see 
cgi_setdrawmode. 
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Diagram: 

Current screen 
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6.2.23 cgi_rect 

Outline an axis aligned rectangle. 

C: 

void cgi_rect( 

Channel *to_cgi, 

int XO, int YO, int XI, int Y1 ) 

Occam: 

PROC cgi.rect( 

CHAN OF ANY to.cgi, 

VAL INT XO, YO, XI, Y1 ) 

Parameters: 


Parameter 

Comment 

to_cgi 

(X0,Y0) 

(XI, Yl) 

Channel to CGI server 

Corner point coordinate 

Opposite point coordinate 


Description: 

cgi_rect plots an outline of an axis aligned rectangle between two diagonally op- 
posite points specified by the coordinates (X0,Y0) and (X1,Y1). 

The outline is clipped to the current screen definition, see cgi_setdrawscreen. 

The current pixel replace and plot modes affect the appearance of the outline, see 

cgi_setdrawmode. 
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Diagram: 
Current screen 
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6.2.24 cgi_rot 
2D region block rotation. 


void cgi_rot( 

Channel *to_cgi, 

screen s, int Xs, int Ys, int LSX, int LSY , 
int Xd, int Yd, float angle ) 

Occam: 

PROC cgi.rot( 

CHAN OF ANY to.cgi, 

VAL [SCREEN. SIZE] INT s, 

VAL INT Xs, Ys, LSX, LSY, Xd, Yd, 

VAL REAL 3 2 angle ) 

Parameters: 


Parameter 

Comment 

to_ c gi 

Channel to CGI server 

s 

Screen 

(Xs , Ys) 

Source coordinate 

LSX 

Size of region in X direction 

LSY 

Size of region in Y direction 

(Xd, Yd) 

Destination coordinate 

angle 

Radian angle of rotation 


Description: 

cgi_rot copies and rotates a rectangular, axis aligned, region from the source 
screen s to the current drawing screen. The size of the source region is specified 
by DX pixels in the X axis direction and DY pixels on the Y axis. It is rotated through 
an angle of angle radians, a positive value denotes an anti-clockwise angle of ro- 
tation. 

The coordinate (Xs,Ys) identifies the top left hand comer of the region on the 
source screen, its rotated copy is plotted at (Xd,Yd) on the current drawing 
screen. 

The rotated region is clipped to the current screen definition, see cgi_setdraws- 
creen. 

The current pixel replace mode affects the resultant display, see cgi_setdraw- 
mode. 
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Diagram: 
Source screen 
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6.2.25 cgl_search 

Scan a horizontal line segment for colour change. 

C: 

int cgi_search( 

Channel *from_cgi, Channel *to_cgi, 
int Xs, int Ys, int Bcol, 
int sense, int dirn ) 

Occam: 

PROC cgi. search ( 

CHAN OF ANY from. cgi, to. cgi, 

VAL INT Xs, Ys, Bcol, sense, dirn, 
INT xposn ) 

Parameters: 


Parameter 

Comment 

from__cgi 
to_cgi 
(Xs, Ys) 

Bcol 

sense 

dirn 

xposn 

Channel from CGI server 

Channel to CGI server 

Search point coordinate 

Colour transition 

Search criteria 

Search direction 

X axis result (OCCAM only) 


Note that cgi_search returns xposn. 

Description: 

cgi_search is used to discover where on a horizontal line, a particular colour 
change occurs. The start point for the search is specified by the coordinate 
(Xs , Ys) , the search occurs along a horizontal line drawn through it. The search 
proceeds in one of two directions: either to the left of the start point, or to its right, 
as specified by dirn. Searching continues until a pixel of the transition colour 
Bcol is discovered, or until a pixel of some other colour is found. The search crite- 
ria sense defines which method to use. 

Valid search direction values are: 


Search direction 

Comment 

SJLEFT 

S_RIGHT 

Search left of start point 

Search right of start point 
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Valid search criteria values are: 


Search test 

Comment 

S_WHILENOT 

S_WHILEGOT 

Search until a pixel of colour Bcol is 
discovered 

Search until a pixel not equal in colour 
to Bcol is discovered 


Diagram: 
Current screen 
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6.2.26 cgi_setbcol 

Set current background colour. 

C: 

oid cgi_setbcol ( 
Channel *to__cgi, 
int Bcol ) 

occam: 

PROC cgi . setbcol ( 

CHAN OF ANY to. cgi, 
VAL INT Bcol ) 

Parameters: 


Parameter 

Comment 

to_cgi 

Bcol 

Channel to CGI server 
Background colour 


Description: 

cgi_setbcol sets the current background colour to Bcol. 
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6.2.27 cgi_setdrawmode 

Set current draw modes for plotting, filling and logical pixel operations. 

C: 

void cgi_jsetdrawmode ( 

Channel *to_cgi , 

int pm, int rm, int fm ) 

occam: 

PROC cgi . setdrawmode ( 

CHAN OF ANY to. cgi, 

VAL INT pm, rm, fm ) 

Parameters: 


Parameter 

Comment 

to_cgi 

pm 

rm 

fm 

Channel to CGI server 

Plot mode 

Replace mode 

Fill mode 


Description: 

eg i_s e tdr awmode sets the current pixel plot, replace and fill modes to pm, rm 
and fm respectively. 

The pixel plot mode pm affects the result of most drawing operations, such as 
cgi_polyline or cgi_arc. Drawing operations are achieved by plotting a se- 
quence of points according to the current plot mode. It defines whether a single 
pixel, the current picture element or the current line style pattern is used to deter- 
mine how each point should be plotted. Valid pixel plot modes are: 
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Plot mode 

Comment 

PM_COL 

Points are plotted as a single pixel in the current fore 
ground colour, see cgi_setfcol 

PM_LINESTYLE 

Points are plotted according to the current line style pat- 
tern, see cgi_setlinestyle 

PM_LINESTYLETR 

As pm_LINESTYLE, except that zero valued linestyle 
pattern pixels are not plotted. This achieves a transpar- 
ency affect 

PMJPEL 

Single points are represented by the current picture ele- 
ment pattern, see cgi_setpel style 

PM__ LS _P EL 

As PM_LINESTYLE, except that single points defined by 
the current line style pattern are replaced by the current 
picture element pattern. 


The pixel replace mode rm affects the result of all drawing and fill operations. It de- 
fines how pixels are ultimately written into the current frame store and therefore the 
colour that each pixel will assume when displayed. Pixels can either be combined 
(using a bitwise operator) with the value of a pixel at the same location, or they can 
be written directly into the frame store. Valid pixel replace modes are: 


Replace mode 

Comment 

RM_COL 

Overwrite mode: pixel defined by the current foreground 
colour, see cgi_setfcol 

RM_AND 

Colour defined by the bitwise AND of the new pixel value 

and the existing framestore pixel 

RM_OR 

Colour defined by the bitwise OR of the new pixel value 
and the existing framestore pixel 

RM_XOR 

Colour defined by the bitwise XOR of the new pixel value 
and the existing framestore pixel 

RM_NOR 

Colour defined by the bitwise NOR of the new pixel value 
and the existing framestore pixel 

RM_NAND 

Colour defined by the bitwise NAND of the new pixel value 
and the existing framestore pixel 

RM_Z 

Overwrite mode: existing framestore pixel only over written 
with zero valued new pixels 

RM_NZ 

Overwrite mode: existing framestore pixel only over written 
with non-zero valued new pixels 

RM_ALL 

Overwrite existing pixel with new pixel value 
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The fill mode fm affects only fill operations, such as cgi_f rect. It defines how 
filling should be performed, valid fill modes are: 


Fill mode 

Comment 

FM_COL 

FM_PATTERN 

Fill with current foreground colour, see 
cgi_ setfcol 

Fill with current fill style, see 
cgi_setfillstyle 
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6.2.28 cgi_setdrawscreen 
Set current drawing screen. 

C: 

void cgi_setdrawscreen ( 
Channel *to_cgi, 
screen s ) 

Occam: 

PROC cgi . setdrawscreen ( 
CHAN OF ANY to. cgi, 

VAL [SCREEN. SIZE] INT s ) 

Parameters: 


Parameter 

Comment 

to_cgi 

s 

Channel to CGI server 

Screen 


Description: 

cgi_setdrawscreen sets the current screen. The screen, specified by s, de- 
fines the size and location of the frame store raster to use for all subsequent CGI 
operations. 
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6.2.29 cgi_setfcol 

Set current foreground colour. 

C: 

void cgi_setf col ( 
Channel *to__cgi, 
int Fcol ) 

Occam: 

PROC cgi . setf col ( 

CHAN OF ANY to. cgi, 
VAL INT Fcol ) 

Parameters: 


Parameter 

Comment 

to_cgi 

Fcol 

Channel to CGI server 

Foreground colour 


Description: 

cgi_setf eol sets the current foreground colour to Fool. 
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6.2.30 cgi_setfillstyle 

Set current customised fill style. 


void cgi_setf illstyle ( 
Channel *to_cgi , 
int fxsize, int fysize, 
char *fillmap ) 

occam: 

PROC cgi . setf illstyle ( 
CHAN OF ANY to. cgi, 

VAL INT fxsize, fysize, 
VAL [ ] BYTE fillmap ) 

Parameters: 


Parameter 

Comment 

to_cgi 

fxsize 

fysize 

fillmap 

Channel to CGI server 

Width of fill style on X axis 

Height of fill style on Y axis 

Fill style pixel map 


Description: 

cgi__setf illstyle sets the current fill style. Fill styles are represented by a two 
dimensional pattern which is used to tile a screen area during patterned fill opera- 
tions: the pattern is replicated over the screen area to be filled. The size of the fill 
pattern is given by fxsize pixels in the X axis direction, and fysize pixels along 
the Y axis. The fill style is described by the vector fillmap which should contain, 
in horizontal line order, each row of pixels that make up the custom fill pattern. The 
maximum width and height of a fill pattern is maxFillSize pixels. 

Note that the current fill style is only used for fill operations if the current fill mode 
is FM_PATTERN, see cgi_setdrawmode. 

The current pixel replace mode affects the resultant display: pixels defined by the 
fill pattern are plotted according to the current pixel replace mode. See cgi_set- 
drawmode. 
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6.2.31 cgi_setfont 
Set current text font. 


C: 

int cgi__setfont ( 

Channel *from__cgi, Channel *to_cgi, 
unsigned int *packfont, 

int nchars , int famw, int fwpc, int flpw ) 

Occam: 

PROC cgi.setfont( 

CHAN OF ANY from. cgi, to. cgi, 

VAL INT [ ] packfont, 

VAL INT nchars, famw, fwpc, flpw, 

BOOL ok ) 

Parameters: 


Parameter 

Comment 

from__cgi 

t°_cgi 

packfont 

nchars 

famw 

fwpc 

flpw 

ok 

Channel from CGI server 

Channel to CGI server 

Encoded font 

Number of characters in font 

Width of unpacked character in bits 
Number of 32 bit words per character 
Number of encoded rows per 32 bit word 
Success status (OCCAM only) 


Note that cgi__setf ont returns non-zero if the font was loaded successfully, zero 
otherwise, cgi. setfont returns the boolean variable ok to indicate success or 
failure. 

Description: 

cgi_setf ont loads a font description into the CGI server. Only one font may be 
active at any one instant so this operation will overwrite any existing font descrip- 
tion held by the server. If there is insufficient memory for the new font cgi set- 
font will return an error status. “ 

Fonts are described by an integer vector which contains a packed representation 
of each character contained in the font. A font can contain any number of charac- 
ters only limited by the memory restrictions of the CGI server. A bit mask is used 
to represent each character cell, this has a constant width and height for all the 
characters of the same font. Bits are listed in horizontal scan line order for each 
character: a one bit represents a coloured pixel and a zero bit the background. The 
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bit masks for each character are packed into a number of 32 bit words, these are 
then concatenated to produce the packed font. The order defines how characters 
are retrieved from the font: the integer value of a character is used as the index of 
the corresponding character cell within the font array, if ASCII text representation 
is required then the font should contain character descriptions at positions that cor- 
respond to the ASCII encoding. 

packfont is an integer vector that describes a font containing nchars charac- 
ters. Character cells are described by the parameters f amw, f wpc and f lpw. The 
width of the font is given by f amw, this specifies the number of bits to use per hori- 
zontal row. Each bit defines whether a foreground or background pixel is plotted, 
f wpc is the number of 32 bit words required to encode one character cell and f lpw 
is the number of horizontal rows encoded per word. 

All text operations use the current font description. 

Section 10.1 ‘Using and defining text fonts’ describes this in more detail. 
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6.2.32 cgi_setlinestyle 

Set current customised line style. 


void cgi_setlinestyle ( 
Channel *to__cgi, 
int n, char *ls, 
int zoomFac ) 

Occam: 

PROC cgi .setlinestyle ( 
CHAN OF ANY to. cgi, 
VAL INT n, 

VAL [ ] BYTE Is, 

VAL INT zoomFac ) 

Parameters: 


Parameter 

Comment 

to_cgi 

Channel to CGI server 

n 

Length of line style 

Is 

Line style pixel map 

zoomFac 

Zoom factor 


Description: 

cgi_setlinestyle sets the current line style. Line styles are represented by a 
one dimensional vector of pixels. During drawing operations, the current line style 
vector can be used to define the value of the next pixel to plot. Pixels are taken from 
the line style vector and used to plot a specific number of subsequent points, as 
defined by the line style zoom factor. When a pixel value has been exhausted the 
next pixel from the line style vector is used, if it was the last pixel then the first pixel 
is re-used. 


is describes a line style of length n pixels. The maximum length of a line style is 
maxLineStyle pixels, the minimum length is 1. 

The number of times a line style pixel is plotted is given by the zoom factor zoom- 
Fac. 

Note that the current line style is only used for drawing operations if the current pix- 
el plot mode specifies one of the line style plot functions, see cgi_setdrawmode. 

The current pixel replace mode affects the resultant display: pixels defined by the 
line style are plotted according to the current pixel replace mode. See cgi set- 
dr a wmode. “ 
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6.2.33 cgi_setorient 

Set current orientation for text and copy operations. 

C: 

void cgi_setorient ( 

Channel *to__cgi, 
int orient ) 

Occam: 

PROC cgi.setorient( 

CHAN OF ANY to.cgi, 

VAL INT orient ) 

Parameters: 


Parameter 

Comment 

to_cgi 

orient 

Channel to CGI server 

Orientation 


Description: 

cgi_setorient sets the current orientation mode to orient. This specifies one 
of eight, axis aligned, orientations to apply when plotting characters or performing 
two dimensional block copy operations (see cgi_copy). Valid orientation values 
are: 


Orientation 

Comment 

TX_NORM 

Normal orientation 

TX_90 

Rotate 90 degrees clockwise 

TX__180 

Rotate 180 degrees clockwise 

TX_270 

Rotate 270 degrees clockwise 

TX__NORMFL I P 

Flip top to bottom 

TX_90FLIP 

Rotate 90 degrees clockwise, then flip 
top to bottom 

TX_180FLIP 

Rotate 180 degrees clockwise, then 
flip top to bottom 

TX_270FLIP 

Rotate 270 degrees clockwise, then 
flip top to bottom 
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6.2.34 cgi_setpelstyle 

Set current customised pel style. 

C: 

void cgi_setpelstyle ( 
Channel *to_cgi / 
int pxsize, int pysize, 
char *pelmap, 
int xorg, int yorg ) 

Occam: 

PROC cgi . setpelstyle ( 

CHAN OF ANY to. cgi, 

VAL INT pxsize, pysize, 
VAL [ ] BYTE pelmap, 

VAL INT xorg, yorg ) 

Parameters: 


Parameter 

Comment 

to_cgi 

pxsize 

pysize 

pelmap 
(xorg, yorg) 

Channel to CGI server 

Width of pel style on X axis 

Height of pel style on Y axis 

Pel style pixel map 

Offset to centre of Pel 


Description: 


cgi_setpelstyle sets the current pel style. Pel styles are represented by a two 
dimensional pattern which is copied into the current screen where a single point 
would otherwise have been plotted. Every operation that is implemented by draw- 

pattern Hi^ead 0 ^ 0 ' 1115, SUC ^ 3S cgi - line ’ 030 be configured to plot the pel style 

The size of the pel pattern is given by pxsize pixels in the X axis direction, and 
pysize pixels along the Y axis. The pel style is described by the vector pelmap 
which should contain, in horizontal line order, each row of pixels that make up the 
custom pel pattern. The maximum width and height of a pel pattern is maxPelsize 


The pe style has a single point, located within its bulk, that identifies an origin Pels 
are plotted such that their origins are positioned at the coordinate of the replaced 

p ?' nt , (xo 5 9 ' yorg) defines the origin of the Pel style as an offset from the base 
of its two dimensional pattern, (top left hand corner). 

The current pixel replace mode affects the resultant display: pixels defined by the 
pel style are plotted according to the current pixel replace mode See cai set- 
dr awmode. 3 — 
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Note that the current pel style is only used for drawing operations if the current pixel 
plot mode specifies one of the pel functions, see cgi_setdrawmode. 

Diagram: 

Current screen 
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6.2.35 cgi_shear 
2D region block shear. 


void cgi_shear( 

Channel *to_cgi, 

screen s, int Xs, int Ys, int LSX, int LSY, 
int Xd, int Yd, 

int LDXx, int LDXy, int LDYx, int LDYy ) 

occam: 

PROC cgi. shear ( 

CHAN OF ANY to. cgi, 

VAL [SCREEN. SIZE] INT s, 

VAL INT Xs, Ys, LSX, LSY, Xd, Yd, 

LDXx, LDXy, LDYx, LDYy ) 

Parameters: 


Parameter 

Comment 

t°_cgi 

Channel to CGI server 

s 

Screen 

(Xs, Ys) 

Source coordinate 

LSX 

Size of region in X direction 

LSY 

Size of region in Y direction 

(Xd, Yd) 

Destination coordinate 

LDXx, LDXy 

LSX shear control 

LDYx, LDYy 

LSY shear control 


Description: 

cgi_shear copies and shears a rectangular, axis aligned, region from the source 
screen s to the current drawing screen. The size of the source region is specified 
by LSX pixels in the X axis direction and LSY pixels on the Y axis. It is sheared ac- 
cording to the value of the four shear control parameters: LDXx, LDXy, LDYx and 
LDYy. LDXx and LDXy control the amount and direction of the shear along the 
lsx line: LDXx is the component of shear in the X axis direction, LDXy is the Y axis 
component. Similarly, LDYx and LDYy control the shear along the LSY line, LDYx 
is the X axis component and LDYy is the Y axis part. Each pair of shear control pa- 
rameters define a right-angled triangle with axis aligned sides, the hypoteneus 
lines define the direction of the sheared horizontal or vertical edges of the original, 
rectangular, region. 

The coordinate (Xs,Ys) identifies the top left hand corner of the region on the 
source screen, its sheared copy is plotted at (Xd,Yd) on the current drawing 
screen. 
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The sheared region is clipped to the current screen definition, see 
cgi_setdrawscreen. 

The current pixel replace mode affects the resultant display, see 
cgi_s e tdr awmode . 


Diagram: 



72 OEK 264 01 


May 1992 


86 


6.2.36 cgi_sptext 

Plot text at specified position, with spacing control. 

C: 

void cgi_sptext( 

Channel *to_cgi, 
int X, int Y, 
int n, char *str, 
int *dx, int *dy ) 

Occam: 

PROC cgi . sptext ( 

CHAN OF ANY to. cgi , 

VAL INT X, Y, n, 

VAL [ ] BYTE str, 

VAL [ ] INT dx, dy ) 

Parameters: 


Parameter 

Comment 

to_cgi 

Channel to CGI server 

(X,Y) 

Start coordinate 

n 

Number of characters to plot 

str 

Character string 

dx 

X axis character spacing distances 

dy 

Y axis character spacing distances 


Description: 


c 9i_ s ptext plots n characters from the character string str according to the 
current font description. The first character is plotted at the current character posi- 
tion, which is initially set to (X, Y) . It is then incremented by X and Y axis offsets 
specified by the inter-character spacing vectors dx and dy, for the character. Sub- 
sequent characters are plotted in the same manner, using the next pair of spacing 
distances. The current character position after the operation completes is offset 
from the first character plotted by X and Y axis distances equal to the sum of the 
dx and dy spacing vectors respectively. 

The spacing vectors should be set with respect to the current orientation, see 
c gi_ se t° r i en t. Characters are plotted according to the current pixel replace 
mode, see cgi_setdrawmode. 

Characters are reproduced at the size of their font, which should be initialised, see 
cgi_setfont. Each pixel of every character plotted is clipped to the current 
screen definition, see cgi_setdrawscreen. 

For text display, the default pixel replace mode RM_COL, will cause characters to 
imprint within a rectangular bounding box of colour 0. In some cases this will not 
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produce the desired effect. If only the foreground of the text is required and a pixel 
overwrite mode rather than a logical operation is desired then select pixel replace 
mode rm__nz. This will cause only those pixels which are non-zero to be plotted. 

Diagram: 


Current screen 
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6.2.37 cgi_strokearc 

Outline part of an axis aligned ellipsoid, closed with chord or segment lines. 

C: 

void cgi_strokearc ( 

Channel *to_cgi, 

int Xc, int Yc, int A, int B, 

int DXs , int DYs, int DXe, int DYe, 

int CloseMode ) 

Occam: 

PROC cgi .strokearc ( 

CHAN OF ANY to.cgi, 

VAL INT Xc, Yc, A, B, DXs, DYs, DXe, DYe, 

CloseMode ) 

Parameters: 


Parameter 

Comment 

to_cgi 

Channel to CGI server 

(Xc, Yc) 

Centre coordinate 

A 

Length of X direction semi axis 

B 

Length of Y direction semi axis 

(DXs, DYs) 

Start vector 

(DXe, DYe) 

End vector 

CloseMode 

Close mode for arc 


Description: 

c gi_strokearc performs the same function as cgi_arcc. However, when 
drawing with a defined line style, cgi_strokearc achieves a more pleasing re- 
sult. This is because cgi_strokearc uses a non-optimal algorithm and calcu- 
lates individual points rather than using a faster (less accurate) technique. 
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Diagram: 
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6.2.38 cgi_text 

Plot text at specified position. 

C: 

void cgi__text( 

Channel * to_cgi , 
int X, int Y, 
int n, char *str ) 

Occam: 

PROC cgi.text( 

CHAN OF ANY to.cgi, 
VAL INT X, Y, n, 

VAL [ ] BYTE str ) 

Parameters: 


Parameter 

Comment 

to_cgi 

(X,Y) 

n 

str 

Channel to CGI server 

Start coordinate 

Number of characters to plot 

Character string 


Description: 

cgi_text plots n characters from the character string str according to the cur- 
rent font description . Characters are plotted at the current character position which 
is then incremented by the currently defined X and Y axis inter-character spacing 
distances, see cgi_chrspace. The current character position after the operation 
completes is offset from the last character plotted by these distances. 

Characters are plotted according to the current pixel replace mode, see cgi_set- 
drawmode and the current orientation, see cgi_setorient. 

Characters are reproduced at the size of their font, which should be initialised, see 
cgi_setfont. Each pixel of every character plotted is clipped to the current 
screen definition, see cgi_setdrawscreen. 

For text display, the default pixel replace mode RM_COL, will cause characters to 
imprint within a rectangular bounding box of colour 0. In some cases this will not 
produce the desired effect. If only the foreground of the text is required and a pixel 
overwrite mode rather than a logical operation is desired then select pixel replace 
mode rm_nz. This will cause only those pixels which are non-zero to be plotted. 
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Diagram: 
Current screen 
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n = 4 

_ • = current character position 
( V = current inter-character spacing 
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6.2.39 cgi_zoom 

2D region block copy with zoom scaling. 

C: 

void cgi_zoom( 

Channel *to__cgi, 
screen s, 

int Xs , int Ys, int LSX, int LSY, 
screen d, 

int Xd, int Yd, int LDX, int LDY, 
int interpolate ) 

occam: 

PROC cgi.zoom( 

CHAN OF ANY to.cgi, 

VAL [SCREEN. SIZE] INT s, 

VAL INT Xs, Ys, LSX, LSY, 

VAL [SCREEN. SIZE] INT d, 

VAL INT Xd, Yd, LDX, LDY, interpolate ) 

Parameters: 


Parameter 

Comment 

to_cgi 

Channel to CGI server 

s 

Source screen 

(Xs , Ys) 

Source coordinate 

LSX 

Size of source in X direction 

LSY 

Size of source in Y direction 

d 

Destination screen 

(Xd, Yd) 

Destination coordinate 

LDX 

Size of destination in X direction 

LDY 

Size of destination in Y direction 

interpolate 

Interpolated zoom flag 


Description: 

cgi_zoom copies a rectangular, axis aligned, region from the source screen s to 
the destination screen d. It performs arbitrary scaling independently in the X and 
Y axis directions to achieve a zoom effect. 

The size of the source region is specified by LSX pixels in the X axis direction and 
LSY pixels on the Y axis. It is scaled to fit the size of the destination region given 
by LDX pixels in the X axis direction and LDY pixels on the Y axis. 

The coordinate (Xs , Ys) identifies the top left hand comer of the region on the 
source screen, it is copied to (Xd, Yd) on the destination screen. 
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interpolate controls whether an interpolated zoom will be performed. If it has 
the value zero, no interpolation will be performed. If it is non-zero an interpolation 
algorithm will be applied when copying pixels to the destination screen. 

The scaled source region is dipped to the destination screen definition. 

The current pixel replace mode affects the resultant display, see cgi_setdraw- 
mode. 


Diagram: 


Source screen s 



Destination screen d 
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7 Graphics board 
functions 


7.1 List of functions 

7.1.1 fs_screenaddr 

Return the raster address of a screen. 

C: 

char *f s_screenaddr ( 

Channel *from_cgi, Channel *to_cgi, 
int bank ) 

Note: 

There is no equivalent Occam variant of this function because the language does 
not support indirect addressing. 

Parameters: 


Parameter 

Comment 

from__cgi 

to_cgi 

bank 

Channel from CGI server 

Channel to CGI server 

Bank number 


Description: 

f s_screenaddr returns what would be the raster address of a physical screen 
if mapped to video memory bank bank. If called from the same processor as the 
CGI server this can be used for directly accessing the raster memory associated 
with a physical screen. 


72 OEK 264 01 


May 1992 


96 


7.1.2 fs_displaybank 
Display a video memory bank. 


void f s_displaybank ( 
Channel *to__cgi, 
int bank ) 

Occam: 

PROC fs .displaybank ( 
CHAN OF ANY to.cgi, 
VAL INT bank ) 

Parameters: 


Parameter 

Comment 

to_cgi 

bank 

Channel to CGI server 

Bank number 


Description: 

f s_displaybank programs the graphics hardware to display a particular bank 
of video memory. The output subsequently generated on a monitor will correspond 
to the contents of the video memory bank identified by bank. 

Physical CGI screens, which have their raster memory areas represented by video 
memory banks, are displayed in this way. See f s_initscreen. 

The video memory bank displayed by f s__displaybank need not correspond to 
the current CGI drawing screen, see cgi_setdrawscreen. 
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7.1.3 fsjnitscreen 

Initialise a physical CGI screen. 

C: 

void f s_initscreen ( 

Channel *from_cgi, Channel *to_cgi, 
screenptr s, 
int bank ) 

Occam: 

PROC fs.initscreen( 

CHAN OF ANY from.cgi, to.cgi, 
[SCREEN. SIZE] INT s, 

VAL INT bank ) 

Parameters: 


Parameter 

Comment 

from_cgi 

to_cgi 

s 

bank 

Channel from CGI server 

Channel to CGI server 

Screen 

Bank number 


Description: 

f s_initscreen creates and initialises a physical CGI screen ready for graphics 
operations. It is returned in s. The horizontal and vertical dimensions of the screen 
are determined by the graphics board display resolution, this is fixed when initialis- 
ing the graphics board with f s_openboard. All physical screens have the same 
dimensions. 

The physical screen has its raster memory area mapped to the video memory bank 
specified by bank. Depending on the display resolution and the total amount of vid- 
eo memory available, a variable number of video memory banks will be present. 
If the bank number is out of range then the screen returned will be mapped to bank 
zero (which is always available) and its X and Y axis dimensions set to zero. This 
renders the screen useless for normal CGI operations. 

The screen can be made visible by displaying the video memory bank associated 
with it, see cgi_displaybank. 
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7.1.4 fs_setpalette 
Set colour palette entry 


void f s_setpalette ( 

Channel *to_cgi, 

int clutno, int red, int green, int blue ) 

occam: 

PROC f s . setpalette ( 

CHAN OF ANY to.cgi, 

VAL INT clutno, red, green, blue ) 

Parameters: 


Parameter 

Comment 

to__cgi 

clutno 

red 

green 

blue 

Channel to CGI server 

Colour palette index 

Red colour component 

Green colour component 

Blue colour component 


Description: 

cgi_setpalette programs one entry in the colour palette. The CGI system uses 
a fixed size colour palette containing maxPalette colour entries. Each entry is 24 
bits wide and consists of a red, a blue and a green component. The entry to pro- 
gram is given by clutno and the corresponding colour components by red 
green and blue. * 

Colour component values range between 0 and 255. Small values indicate a low 
intensity and larger values a higher intensity. 

The include files: colours . h and colours . inc contain red, green and blue co- 
lour component definitions for a number of interesting colours. 
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7.1.5 fs_openboard 
Initialise a graphics board for use. 


void f s_openboard ( 

Channel *to_cgi, 

VTG vtg ) 

occam: 

PROC f s . openboard ( 

CHAN OF ANY to.cgi, 

VAL [VTG. SIZE] INT vtg ) 

Parameters: 


Parameter 

Comment 

to_cgi 

vtg 

Channel to CGI server 

Video timing parameters 


Description: 

fs_openboard initialises a graphics board. It causes the CGI display server to 
perform whatever device dependent actions are necessary to setup the graphics 
board ready for use, a graphics board must be opened before it can be used for 
displaying the output of CGI operations. 

A single parameter is required: vtg. This should contain monitor and display reso- 
lution specific video timing parameters to initialise the CVC on the graphics board. 
It is important that these parameters match the capabilities of an attached monitor. 
Chapter 5 has a more detailed description of this. The include files: video .h and 
video . inc contain a number of constant video parameter block definitions that 
may be applicable. 

In normal circumstances the control register field of the parameter block should be 
set to zero. This will cause the device dependent library assoicated with a particular 
graphics board to program the CVC control register in a board specific way. This 
can be overridden by specifying a non-zero value to write to the control register. 
In ANSI C, the field is vtg . control, in Occam it is vtg [VTG . CONTROL] . 
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7.1.6 fs_closeboard 
Terminate use of a graphics board. 

C: 

void f s_closeboard ( Channel *from_cgi, Channel *to_cgi ) 

Occam: 

PROC f s . closeboard ( CHAN OF ANY from.cgi, to.cgi ) 
Parameters: 


Parameter 

Comment 

£rom__cgi 

t°__ c gi 

Channel from CGI server 

Channel to CGI server 


Description: 

closeboard performs whatever device dependent operations are neces- 
sary to terminate use of the graphics board. The actual actions taken will depend 
on the graphics hardware being used. 
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7.1.7 fs_writeregs 
Write graphics board registers. 

C: 

void f s_writeregs ( 

Channel *to_cgi, 

int n, int ^registers, int ^contents ) 

Occam: 

PROC fs .writeregs ( 

CHAN OF ANY to.cgi, 

VAL INT n, 

VAL [ ] INT registers, contents ) 
Parameters: 


Parameter 

Comment 

t°_cgi 

Channel to CGI server 

n 

Number of registers 

registers 

Register addresses 

contents 

Register contents 


Description: 

fs_writeregs causes the CGI display server to program graphics board regis- 
ters. This allows full access to the hardware control registers of any graphics board 
in a device dependent way. registers should contain the addresses of the 
graphics board registers to program, they will be written with the contents of con- 
tents. The number registers to program is given by n. 
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8 ANSI C user guide 

This chapter contains a user guide for ANSI C toolset developers. It provides all 
the information necessary to develop graphics software for a transputer system, 
incorporating an /q Systems graphics board, with the IMS F003C and an ANSI C 
toolset. It should be read in conjunction with the appropriate toolset documenta- 
tion. 

8.1 Toolset search path 

The toolset search path I SEARCH should be setup to include the following directo- 
ries: 

• cWve.\F003C\CLiB 

• aWve.\F003C\BOARDS 
For example, with: 

SET ISEARCH=C : \F003C\CLIB\ C:\F003C\BOARDS\ 

8.1.1 IMS F003C library and include files 

The following libraries will then be on the search path: 


Library 

Purpose 

CGILIB . LIB 

B419.LIB 

B419A.LIB 

B437.LIB 

ANSI C CGI library 

IMS B419 board support library 

IMS B419 (G300A) board support library 
IMS B437 board support library 


and the following header files: 


Include file 

Purpose 

cgilib.h 
cgi types .h 

colours .h 

video. h 

CGI library prototypes 

CGI constant and type definitions 

Colour definitions 

Video timing parameters 
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8.2 Invoking the CGI display server 

The CGI display server has the following entry point: 


CgiServer ( Process *p, Channel *to_cgi, Channel *from_cgi ) 

It must be invoked as a transputer process from a program running on a suitable 
graphics board. The channels to_cgi and f rom_cgi are used to connect the 
server to application software running on the same transputer, or on some other 
transputer located elsewhere in the network. 

The CGI server can be used in the following ways: 

• By starting it from a C program and allowing the same program to engage 
in graphics operations. This is a single processor example where the ap- 
plication software and the CGI server run in parallel on the same transput- 
er. 


• By moving the invocation of the CGI server into a separate program and 
using the toolset configuration tools to place programs on different trans- 
puters. This technique can be used to build single and multiprocessor ap- 
plications. 

8.2.1 Single processor, single program 

In this example, the CGI server is started with ProcRun and the main program con- 
tinues in parallel. The main program calls functions from the CGI library to interact 
with the server, it can subsequently stop the server by calling cgi_terminate. 

#include <stdio.h> 

#include <process.h> 

#include <channel.h> 

linclude <cgilib.h> 
jjfinclude <cgi types. h> 


int main () 
{ 


Process *cgi; 

Channel * to__cgi , * f r om_cgi ; 

/* Allocate the CGI channels */ 


to_cgi « ChanAlloc () ; 
from_cgi = ChanAlloc (); 


if ( (to_cgi = NULL) | | (from__cgi = NULL) ) 

printf ( "Failed to allocate channel\n" ) ; 
abort () ; 


) 

/* Allocate the CGI server process */ 
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/* The CGI server stack size is given by CGI_STACK_SIZE 

from the header file <cgi types .h>. The server requires two 
parameters: the "to_cgi" and "from^cgi" channels. */ 

cgi * ProcAlloc ( CgiServer, CGI_STACK_SIZE, 2, to_cgi, 
from_cgi ) ; 

if ( cgi = NULL ) 

{ 

printf( "Failed to allocate process\n" ); 
abort ( ) ; 

> 

/* Start the CGI server, the main program continues */ 

ProcRun ( cgi ) ; 

/* Use functions from the CGI linrary to interact with the 
CGI server. The first initialises the CGI system, others 
are used to perform graphics operations. The CGI server 
can be terminated with "cgi_terminate" . */ 

cgi_init( to_cgi ) ; /* Initialise the CGI system */ 


/* Open the graphics board and do lots of graphics . . . 
close the graphics board when done */ 


/* Application finished, time to terminate the CGI server */ 
cgi_terminate ( from_cgi, to_cgi ); 


} 
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8.2.2 Multiprocessor, multi program 

This example has two programs running in parallel. One is responsible for running 
the CGI server and the other is an application which communicates with the server 
using placed transputer channels. The toolset configuration utilities are used to de- 
clare and place the programs, and the channels connecting them, onto the avail- 
able hardware. 

finclude <stdio.h> 
finclude <process.h> 
finclude <channel.h> 

finclude <misc.h> /* For get_param() */ 

finclude <cgilib.h> 
finclude <cgi types. h> 

int main() 

{ 

Process *cgi; 

Channel *to__cgi, *from_cgi; 

/* Get the CGI channels from the configuration environment, 
these may have been mapped onto transputer links and 
connected to another processor. Alternatively, they may 
connect this program to another program running on the 
same processor. */ 

to_cgi = get_param(3) ; 

from__cgi = get_param (4) ; /* Defined by interface mapping */ 

/* Allocate the CGI server process */ 

/* The CGI server stack size is given by CGIJSTACK SIZE 

from the header file <cgitypes.h>. The server requires two 
parameters: the "to_cgi" and "from_cgi" channels. */ 

cgi = ProcAlloc ( CgiServer, CGIJSTACK_SIZE, 2, to cgi, 
from__cgi ) ; “ 

if ( cgi = NULL ) 

( 

printf ( "Failed to allocate process\n" ) ; 
abort (); 

> 

/* Start the CGI server and wait until it is terminated by 
the application software, this program will then terminate 
as well */ 

ProcPar ( cgi , NULL ) ; 


> 
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This could be simplified by calling the CGI server function inline. If this is done the 
process descriptor parameter Process *p must be passed to the function ex- 
plicitly. It can be set to any value, for example: 

#include <stdio.h> 

♦include <channel.h> 

# include <misc.h> /* For get_param() */ 

♦include <cgilib.h> 

#include <cgi types. h> 

int main() 

{ 

Channel *to_cgi, *from__cgi; 

/* Get the CGI channels from the configuration environment, 
these may have been mapped onto transputer links and 
connected to another processor. Alternatively, they may 
connect this program to another program running on the 
same processor. */ 

to_cgi = get_param(3) ; 

from_cgi = get_param(4) ; /* Defined by interface mapping */ 

/* Start the CGI server and wait until it is terminated by 
the application software, this program will then terminate 
as well */ 

CgiServer ( NULL, to_cgi, fromcgi ); 


} 

8.3 Configuring transputer memory sizes 

The amount of memory available on a transputer for program storage is specified 
by IBOARDSIZE (single transputer system) or by a configuration description. 
When specifying the amount of memory available on a graphics board with contig- 
uous DRAM and VRAM, care should be taken to ensure that program code or data 
is not assigned to VRAM that will be used for graphics operations. 
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8.4 Opening the graphics board 

Before any output can be displayed on a monitor the graphics board must be initial- 
ised. This is done by calling f s_openboard with a suitable set of video timing pa- 
rameters. Parameters for varying display resolutions and different monitor types 
are provided in the include file video . h. The following example shows the typical 
steps taken by an application program during initialisation: 

#include <atdio.h> 

#include <process.h> 

♦include <channel.h> 

♦include <cgilib.h> 

♦include <cgi types. h> 

♦include <video.h> /* For video timing parameters */ 

int main() 

{ 

/* start the CGI server and allocate channels to it, 

these are "to_cgi" and "from_cgi". Alternatively, the 
CGI server may already be running in another program */ 

/* Declare and initialise a video timing parameter block, 
Y_1024_768 is defined in <video.h> and specifies a set 
of parameters for a 1024 by 768 pixel display. */ 

VTG v = v_1024_768 

screen s; /* A CGI screen */ 

/* Initialise the graphics board */ 

f s_openboard ( to__cgi , v ) ; 

/* Initialise a physical screen and map it to video 
ram bank 0. */ 

f s_initscreen ( from_cgi, to_cgi, &s, 0 ); 

/* Set current drawing screen to s and display it 
on the output monitor. */ 

cgi_setdrawscreen( to_cgi, s ); /* Now drawing in s */ 

' di s pi a y^ank ( to__cgi, 0 ); /* Bank 0 now displayed */ 

/* CGI drawing operations will now be displayed ... */ 
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8.5 Compiling and linking IMS F003C programs 

8.5.1 Compiling 

There are no special compilation requirements for programs that use the IMS 
F003C libraries. 

A default font can be enabled by including the header file cgi types . h and compil- 
ing with the preprocessor flag _FONT defined. For example, with: 

icc example. c /t8 /D_FONT 

This uncomments an unsigned int array called font8by8 that contains a 
simple font definition for use with cgi_setf ont. 

8.5.2 Linking 

Software calling functions from the CGI library should be linked against CGI- 
LIB.LIB. 

Programs which invoke the CGI server must be linked with one of the board sup- 
port libraries. 

8.6 Example program 

The directory \F003C\CLIB\examples contains an example program. It is des- 
gined to run on a single transputer configuration: one of the /q Systems graphics 
boards. 

To build and run it: 

icc example. c /ta /D_FONT 

ilink example. tco cgilib.lib board. lib /f startup. Ink /ta 
(Where board is the name of a specific graphics board). 

icollect example. lku /t 
iserver /se /sb example. btl 
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9 occam user guide 

This chapter contains a user guide for Occam toolset developers. It provides all 
the information necessary to develop graphics software for a transputer system, 
incorporating an /q Systems graphics board, with the IMS F003C and an Occam 
toolset. It should be read in conjunction with the appropriate toolset documenta- 
tion. 

9.1 Toolset search path 

The toolset search path isearch should be setup to include the following directo- 
ries: 

• dr/Ve:\F003C\OCCAMLlB 

• dnVe\F003C\BOARDS 
For example, with: 

SET ISEARCH=C : \F003C\OCCAMLIB\ C:\F003C\BOARDS\ 

9.1.1 IMS F003C library and include files 

The following libraries will then be on the search path: 


Library 

Purpose 

CGILIB. LIB 

LIBCRED . LIB 

B419.LIB 

B419A.LIB 

B437.LIB 

Occam CGI library 

Reduced C runtime library 

IMS B419 board support library 

IMS B419 (G300A) board support library 
IMS B437 board support library 


and the following header files: 


Include file 

Purpose 

cgilib.inc 

colours . inc 

video . inc 

CGI constant definitions 

Colour definitions 

Video timing parameters 
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9.2 Invoking the CGI display server 

The reader may need to refer to the chapter entitled Mixed language programming 
in the appropriate Occam toolset user manual when reading this section. 

The CGI display server is implemented as a C function, when calling it from an Oc- 
cam program it has the following entry point: 

Cgi Server ( VAL INT gsb, p, CHAN OF ANY to.cgi, from.cgi ) 

It must be invoked by a program running on a suitable graphics board The chan- 
nels to.cgi and from . cgi are used to connect the server to application software 
running on the same transputer, or on some other transputer located elsewhere 
in the network. 


Because the CGI server is implemented in C it requires the invoking Occam pro- 
gram to setup a C environment. Support for this is provided by the Occam toolset 
with the callc . lib library. This contains a number of procedures for setting up 
and initialising a C function call from Occam. 


The CGI server requires a static and a heap area. These are allocated from an INT 
array declared by the calling Occam program. The array must be big enough to 
hold the static variables used by the CGI server and provide enough space for a 
heap. The heap is used to allocate dynamic storage for loadable fonts (see 
cgi . setf ont), it should be large enough to hold the biggest font required by an 
application. The static space required by the CGI server is constant and can be 
satisfied with a 5000 word int array, additional space in the array will be used for 
the heap. The workspace requirement of the CGI server is specified by a compiler 
# PRAGMA in the include file cgilib . inc. 


The CGI server can be used in the following ways: 

• By running it in parallel with an application contained in the same program 
This is a single processor example where the application software and the 
CGI server run in parallel on the same transputer. 

• By moving the invocation of the CGI server into a separate program and 
using the toolset configuration tools to place programs on different trans- 

pHcatfon ^ IS ^ ec ^ n,< ^ ue can usec * *° build s,n 9^ and multiprocessor ap- 


9.2.1 


Single processor, single program 


In this example, the CGI server is run in parallel with the application from a single 
program The application calls procedures from the CGI library to interact with the 
server, it can subsequently stop the server by calling cgi . terminate 
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#USE "hoatio. lib" 

# INCLUDE "hoatio . inc" 

#USE "callc.lib" — occam toolset library 

#USE "cgilib.lib" 

# INCLUDE "cgilib.inc" 

PROC example ( CHAN OF ANY fa, ta, []INT free. mem ) 

INT gab, static. site: — For the static area 
CHAN OF ANY to.cgi, from.cgi: 


SEQ 

— Determine the exact amount of static apace required by 

— the CGI server. 


init. static ( [free. mem FROM 0 FOR 0], static. size, gab ) 
IP ( static. size > (SIZE free. mem) ) 


so.write.string.nl ( fs, ts, "No memory for CGI statics" 
so. exit ( fs, ta, sps. failure ) 

CAUSEERROR ( ) — Stop the transputer 

TRUE 

SKIP 


> 


— Abbreviate the static and heap areas from the free. mem 

— INT array, "static. size" gives the amount of static apace 

— required. The rest of free. mem is used as heap space. 


static. area IS 
heap. area IS 


[free. mem FROM 0 FOR static . size] : 

[free .mem FROM static. size FOR 

(SIZE free. mem) - static. size] : 


SEQ 

— Initialise the static and heap areas. 

INT unused. size: — Don't need the size 
init. static ( static. area, unused. size, gsb ) 
init. heap ( gsb, heap. area ) 

— Run the CGI server in parallel with application software 
PAR 

CgiServer( gsb, 0, to.cgi, from.cgi ) 

SEQ 

— ose procedures from the CGI library to interact with the 

— CGI server. The first initialises the CGI system, others are 

— used to perform graphics operations. The CGI server can be 

— terminated with "cgi . terminate" . 

cgi . init ( to.cgi ) — Initialise the CGI system 


— Open the graphics board and do lots of graphics . . . 

— close the graphics board when done 


— Application has finished, time to terminate the CGI server 
cgi . terminate ( from.cgi, to.cgi ) 
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9.2.2 Multiprocessor, multi program 


This example has two programs running in parallel. One is responsible for running 
the CG server and the other is an application which communicates with the server 
using placed transputer channels. The toolset configuration utilities are used to de- 

abTe^^rdwSe 6 ** P^Og^amS, and the channels connecting them, onto the avail- 


#USE "hostio . lib" 

# INCLUDE "hostio. inc" 


#USE "callc.lib" — Occam toolset library 

#USE "cgilib.lib" 

# INCLUDE "cgilib.inc" 


PROC example ( CHAN OF ANY fs, ts, from.cgi, to.cgi ) 

INT gsb, static. size: — For the static area 

f 4 0001 tot ? tatiC area: — Enou 9 h for the CGI server 
[4000] INT heap. area: — Enough for an interesting font 

SEQ 


__ ™ CGI channeis come from the configuration environment, 
_ these * aVG **** mapped onto transputer links and 
' connecte d ^ another processor. Alternatively, they may 

- 3^ e procesfor r ° grar " t0 an ° ther pro ' 3ram running on the 


“ Initialise the static and heap areas 

init. static ( static. area, static. size, gsb ) 
init.heap( gsb, heap. area ) 


- th» r ^ e S6rV ! r and wait <“til it is terminated by 

— ^ well 1 tl0n software ' 0118 Program will then terminate 


CgiServer ( gsb, 0, to.cgi, from.cgi ) 


9.3 


Configuring transputer memory sizes 


by h ?BoCsi f 2 ETnnif, ailable ?" a tra , ns P uter for P r °9 ra ™ borage is specified 
IB0ARD f IZE (single transputer system) or by a configuration descriotion 

SbDRAmSIS VRAM ' 3Unt ° f h me | T K ry available on a 9 ra P hics board with contig- 
uous DRAM and VRAM, care should be taken to ensure that proqram code or data 

is not assigned to VRAM that will be used for graphics operations. 

9.4 Opening the graphics board 

ised Thic k°Hnn Ut r n b ir displayed on a m °nitorthe graphics board must be initial- 
d. This is done by calling f s . openboard with a suitable set of video timing pa- 
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rameters. Parameters for various display resolutions and different monitor types 
are provided in the include file video . inc. The following example shows the typi- 
cal steps taken by an application program during initialisation: 

#USE "cgilib.lib" 

# INCLUDE "cgilib . inc" 

# INCLUDE "video. inc" — For video timing parameters 
PR0C example ( CHAN OF ANY from.cgi, to.cgi ) 

— Start the CGI server and declare channels to it, 

— these are "to.cgi" and "from.cgi". Alternatively, the 

— CGI server may already be running in another program. 

— Declare and initialise a video timing parameter block, 

— V. 1024. 7 68 is defined in video. inc and specifies a set 

— of parameters for a 1024 by 768 pixel display. 

[VTG . SIZE] INT v: 

[SCREEN. SIZE] INT s: — A CGI screen 
SEQ 

v :« V. 1024. 768 

— Initialise the graphics board 
f 3 . openboard ( to . cgi , v ) 

— Initialise a physical screen and map it to video 

— ram bank 0. 

fs .initscreen ( from.cgi, to.cgi, s, 0 ) 

— Set the current drawing screen to s and display it 

— on the output monitor. 

cgi . setdrawscreen ( to.cgi, s ) — Now drawing in s 

f s . displaybank ( to.cgi, 0 ) — Bank 0 now displayed 


— CGI drawing operations will now be displayed . . . 
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9.5 Compiling and linking IMS F003C programs 


9.5.1 Compiling 

There are no special compilation requirements for programs that use the IMS 
F003C libraries. 


9.5.2 Linking 

Software calling procedures from the CGI library should be linked against cgi- 


Programs which invoke the CGI server must be linked with one of the board sup- 
port libraries and also the Occam toolset mixed language support library: 
callc . lib. In addition, the reduced C runtime library libcred . lib is also re- 
quired. This file is normally supplied with an ANSI C toolset. However, because 
most Occam developers will probably not have a C toolset the library is also sup- 
plied with the IMS F003C software. It can be found in \F003C\OCCAMLIB 


9.6 Example program 

The directory \foo3c\occamlib\examples contains an example program It Is 
desgined to run on a single transputer configuration: one of the iq Systems graph- 
ics boards. 

To build and run it, type: 
oc example. occ /ta 

ilink example. tco cgilib.lib board. lib callc. lib 

hostio. lib convert. lib libcred. lib /f occama.lnk /ta 
(Where board is the name of a specific graphics board), 
icollect example. lku /t 
iserver /se /sb example. btl 
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10 Further use of the 
CGI system 


This chapter contains more detailed information concerning the use of various as- 
pects of the CGI system. 

10.1 Using and defining text fonts 

Text fonts are downloaded to the CGI server with cgi_setfont. This defines bit- 
maps for the various character cells that make up the font. Because the CGI sys- 
tem uses heap space to hold a font definition it should be invoked with enough heap 
memory available to hold the largest font to be used. Only one font is held by the 
CGI server at a time, if an application requires the use of multiple fonts then it will 
have to load each one as and when needed. 

A default font is supplied with the IMS F003C software. It contains a fixed size 
ASCII character set defined within an eight by eight pixel character cell. By includ- 
ing the file cgilib . inc, Occam programmers will have access to a val [ ] INT 
array called font . 8 .BY . 8 which contains the font definition. ANSI C program- 
mers should include cgi types .h which if compiled with the preprocessor vari- 
able __FONT defined will un-comment an unsigned int array font8by8 that 
contains an equivalent font. 

When downloading a font, the cgi_setf ont function requires various font char- 
acteristics to be defined. These specify, for example, the number of 32 bit words 
used to hold the bit pattern of a single character cell. There are four parameters 
required to define a font: 


Font parameter 

Purpose 

famw 

fwpc 

flpw 

nchars 

Font area memory width (in bits) 

Number of 32 bit words per character 

Number of character lines per 32 bit word 
Number of characters in the font 


The default font is supplied with definitions for these values, for example, in C they 
are: font_FAMW, font_FWPC, font_FLPW and font_NCHARS. 

If necessary, the programmer can define additional fonts or perhaps convert exist- 
ing fonts from some other environment into this format. The following example 
shows how the font parameters relate to the bit mask used to represent each char- 
acter cell defined by the font. 
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In the supplied 8 by 8 pixel font, the character 0 is represented by the following bit 
mssk. 


8 



Figure 10.1 Character ‘O’ representation in font 8 by 8 

This is stored in two 32 bit words: 0xd6cec67c, which describes the top half of the 
character cell, and 0x007cc6e6 forthe bottom half. The origin of the character cell 
is defined to be the top left hand corner. The first word defines lines in horizontal 
row order , starting with the least significant bit. In this example, the least significant 
byte of the first word is 0x7c, this represents the first row of the character cell with 
the bit mask oilllioo. 

The complete font is represented by an array of 32 bit words, each pair of words 
is used to encode the definition of a single character. The byte value of a character 
is used as an index into this array when retrieving a character definition in order 
to plot it. The 8 by 8 font is defined by the following font parameters: 


Font parameter 

Value 

famw 

8 pixels wide 

fwpc 

2 x 32 bits per character 

flpw 

4 x character lines per 32 bit word 

nchars 

164 characters 
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10.2 Using CGI screens for windowing 

The CGI screen abstraction can be used to form the basis of a windowing like, 
graphical user interface. Such interfaces typically use two dimensional screen 
areas to represent objects such as popup menus, dialogue boxes or text windows. 
These objects can all be implemented using facilities provided by the CGI library. 

The CGI screen structure describes a two dimensional region of raster memory 
that the CGI system performs graphical operations within. The size of the screen 
defines the extent of drawing operations: drawing is clipped to the boundary of the 
screen. There are two types of screen. The first has a raster stored in normal 
memory and can never be displayed on a monitor, the second type is designed to 
be displayed on a monitor and has a raster stored in video memory, its screen di- 
mensions match the resolution of the monitor. CGI primitives for copying, scaling 
or rotating screens can be used to copy a part of one screen to another. 

An existing screen structure can be used to create another. If the new screen refers 
to an existing, but smaller area of the original, then it can be used to represent a 
window. When selected as the current screen, the CGI system will clip all further 
drawing operations to its extent. This will create the effect of drawing in a bounded 
window, the background will be protected. By combining this with the CGI copy or 
rotation primitives, simple windowing can be implemented. In the example, the 
background area would have to be copied elsewhere while the window is manipu- 
lated and then copied back again to restore it. 

The following example demonstrates some of these techniques: 


# include 
# include 
# include 
# include 
# include 
#include 


<stdio.h> 
<mathf .h> 
<math.h> 
<stdlib.h> 
<channel . h> 
<process .h> 


#include <cgilib.h> 
#include <video.h> 
#include <colours.h> 


/* 

* sub screen - create a sub screen from an existing screen 


void sub_screen( screen *new, screen old, 
int xorg, int yorg, 
int xsize, int ysize ) 

/* Ensure that the new screen fits on the old one */ 
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if ( (xorg >= old.xsize) | | (yorg >= old.ysize) ) 
return; 

/* Clip the new screen dimensions to the extent of the 
old screen. The stride must remain the same as the old 
screen because the new raster is not contiguous. */ 

new->raster = old. raster + (yorg * old.xsize) + xorg; 
new->xsize = xorg + xsize > old.xsize ? old.xsize - xorg : xsize; 
new->ysize = yorg + ysize > old.ysize ? old.ysize - yorg : ysize; 
new->stride = old. stride; 
new->multiMode = old. mill tiMode; 

) 

/* 

* main 


int main () 

( 

Process *cgi; 

Channel * to_cgi , * f rom__cgi ; 

VTG v = V_1024_768; 

screen si, s2; /* Declare two screen structures */ 

/* Allocate channels to the CGI server */ 

to_cgi = ChanAlloc ( ) ; 
from_cgi = ChanAlloc {); 

if ( ( to_cgi aa NULL) | | (from_cgi = NULL) ) 

printf ( "Failed to allocate channel\n" ); 
abort ( ) ; 


/* Allocate and start the CGI server */ 

cgi = ProcAlloc ( CgiServer, CGI STACK SIZE, 2 , to cgi, from cai ); 
if ( cgi = NULL ) ~ “ “ 

< 

printf ( "Failed to allocate process\n" ) ; 
abort ( ) ; 

) 

ProcRun ( cgi ) ; 

/ Initialise the CGI server and open the graphics board */ 

cgi_init ( to_cgi ) ; 
f s_openboard ( to__cgi, v ); 

/* Program some simple colours into the palette */ 
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fs setpalette ( to_cgi, 2, LINEN_R, LINEN_G, LINEN JB ); 
f s”setpalette ( to_cgi, 3, SKYBLUE_R, SKYBLUE_G , SKYBLUEJB ); 

/* Initialise a physical screen and display it */ 

fs_initscreen ( from_cgi, to cgi, &sl, 0 ); 

printf ( "Screen initialised\nraster = Ox%x xsize = %d ysize %d\n", 
(int) (si. raster) , si. xsize, si. ysize ); 
fs_displaybank( to_cgi, 0 ); 

/* Allocate a new screen, derived from si, which represents a 
window like viewport into the original screen. */ 

sub_screen( &s2, si, 100, 200, 200, 200 ); 

/* Clear both screens. Note the order in which this is done. 

The background screen si is cleared first, the window screen 
s2 is cleared afterwards. */ 

cgi_cls( to_cgi, si, 2 ) ; /* Clear background to LINEN */ 

cgi_cls( to_cgi , s2, 3 ); /* Clear window screen to SKYBLUE */ 

/* Select the window screen as the current drawing screen and 
write some text into it. This could be used as a popup window 
or a menu selection etc. */ 

cgi_setdrawscreen ( to_cgi, s2 ); 

cgi_setf col ( to_cgi, 2 ); /* Drawing colour is now LINEN */ 

cgi_setbcol( to_cgi, 0 ); /* Background colour is 0 */ 

/* Down load a font and initialise text attributes */ 

cgi_chr space ( to_cgi, 10, 0 ); 
cgi_setfont( from_cgi, to_cgi, font8by8, 

f ont_NCHARS , font_FAMW, font_FWPC, font_FLPW ); 
cgi_setorient ( to_cgi , TX_N0RM ) ; 

/* A pixel replace mode of move non-zero will cause text to 
be written in the current foreground colour while ignoring 
the background (because the background colour is now 0) . */ 

cgi_set drawmode ( to__cgi, PM_C0L , RM_NZ, FW_C0L ); 

/* Print some text in the window, note that it will be clipped 
to the extent of s2 */ 

cgi_text( to__cgi, 20, 20, 13, "Hello World !" ); 

/* Close the graphics board and terminate the CGI server */ 

fs_closeboard( from_cgi, to__cgi ); 
cgi_terminate ( from_cgi, to_cgi ); 
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10.3 Simple animation techniques 


Provided a graphics board has enough video memory to support more than one 
physical CGI screen, simple animation can be achieved. This is done by cycling 
the graphics board hardware through the available screens, displaying each in 
turn, whilst changing the contents of the screen just about to be displayed. 

For example, a simple cube like object could be made to continuously spin around 
some axis of rotation. To do this, the cube would first have to be drawn at a starting 
position and displayed. Meanwhile, the CGI system would be instructed to draw 
a second cube in another, invisible, screen. It would be drawn with a small physical 
displacement from the first cube. When the second cube is complete the displayed 
screen and the invisible screen are toggled: the displayed screen becomes invis- 
ible, and the screen with the new cube, visible. If this process is continued an 
animation effect can be achieved as the cube continuously moves around on the 
display. 

The technique is best demonstrated with an example. The following program uses 
a pair of physical CGI screens to animate a rotating disk, note the use the 
cgi_f circle function which has its axis parameters altered after drawing every 
new circle, this combines to produce a three dimensional effect. 

/* 

* main 


V 

int main ( ) 

{ 

Process *cgi; 

Channel *to_cgi, *from cgi; 

/* Declare two screens in an array, bank will be used to 
alternate which screen is displayed, and which screen is 
drawn into. */ 


screen s[2]; 

int axis, bank, step; 


VTG v = V_1024_768; 

/* Allocate channels to the CGI server */ 

to_cgi = ChanAlloc () ; 
from_cgi = ChanAlloc (); 


if ( ( to_cgi = NULL) | | (from_cgi = NULL) ) 


printf ( "Failed to allocate channel\n" ) ; 
abort ( ) ; 


/* Allocate and start the CGI server */ 

cgi = ProcAlloc ( CgiServer, CGI STACK SIZE, 2, to cgi, from cgi ); 
if ( cgi = NULL ) “ “ “ - y " 

{ 

printf ( "Failed to allocate process\n" ); 
abort () ; 
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I 

ProcRun ( cgi ) ; 

/* Initialise the CGI server and open the graphics board */ 

cgi_init ( to_cgi ) ; 
fs_openboard( to_cgi, v ); 

/* Initialise a pair of physical screens */ 

fs initscreen( from cgi, to cgi, &s[0], 0 ); 

prlntf( "Screen ini£ialised\nraster = Ox%x xsize = %d ysize %d\n", 
(int) (s [0] .raster) , s[0]. xsize, s[0). ysize ); 

fs initscreen( from cgi, to cgi, fis[l], 1 ); 

prTntf ( "Screen inrEialisedTnraster = Ox%x xsize = %d ysize %d\n", 
(int) (s [1] .raster) , s [1] . xsize, s[l). ysize ); 

/* Setup the palette with some simple colours */ 

f s_setpalette ( to_cgi, 0, LINEN_R, LINEN_G, LINENJ3 ); 
f s__setpalette ( to_cgi, 1, YELLOW_R, YELLOW_G , YELLOW_B ); 

cgi__setf col ( to_cgi, 1 ); /* Drawing colour is YELLOW */ 

cgi_cls( to_cgi, s[0], 0 ); 

cgi_cls( to__cgi, s[l], 0 ); /* Clear both screens to LINEN */ 

axis = 0; 

step =5; /* Axis dimensions change in a step of 5 pixels */ 

/* Initially, screen [0] is drawn into, and screen [1] 

is displayed, bank is used to index each screen from the 
screen array. */ 

bank = 0; 

fs^displaybank( to__cgi, bank A l); 
cgTjsetdrawscreen ( to_cgi, s[bankj ); 

cgi_f circle ( to__cgi, 500, 350, axis, 200 - axis ); 

bank A = 1; /* Toggle bank */ 

axis += step; /* Step the circle axis */ 

while (1) /* Do this continuously */ 

{ 

f s displaybank ( to_cgi , bank A 1 ) ; 
cgi_setdrawscreen ( to_cgi , s [bank] ) ; 

/* Wipe the old circle from the screen by clearing it, 
and draw a new circle. Alter the circle axis step if 
the axis has reached the end of its range. */ 

cgi__cls( to cgi, s[bank], 0 ); 

cgi_fcircle7 to_cgi, 500, 350, axis, 200 - axis ); 

if ( (axis = 200) | | (axis = 0) ) step = -step; 

bank A = 1; /* Toggle bank */ 

axis += step; /* Step the circle 2 Lxis */ 

) 


) 
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10.4 Writing a board support library 

The source code of board support libraries for <q Systems graphics board products 
supported by the IMS F003C software is supplied in the directory: 
\F003C\BOARDS\SOURCE. This should allow a new version of a board support 
library to be created for some other transputer based graphics board. 

The interface required by the CGI server defines the functions that must be pro- 
vided by a board support library. They are: 


Function 

Purpose 

FS__S CREENADDR 

FS_D I S PLA YBANK 
FS__INI TSCREEN 
FS__SETPALETTE 
FS_OPENBOARD 
FS_CLOSEBOARD 
FS_WRI TEREGS 

Return the address of a physical screen 

Display a bank of video memory 

Initialise a screen, map it to video memory 
Program a colour palette location 

Do device specific initialisation 

Do device specific termination 

Write board control registers 


The source code is well commented and should contain all the information neces- 
sary to port it to another graphics board. 
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A Directory structure 


IMS F003C files are installed within the following directory structure:- 


drive: \F003C 


/ 

\ 


/ 


\ 

BOARDS CLIB 

OCCAMLIB 

SOURCE EXAMPLES 

EXAMPLES 


Which, after a successful installation, should contain the following files:— 

drive : \F003C\clib 
CGILIB.LIB 
CGILIB.H 
CGITYPES.H 
COLOURS. H 
VIDEO. H 

drive: \F003C\clib\examples 
EXAMPLE. C 

drive: \F003C\OCCAMLIB 
CGILIB.LIB 
LIBCRED .LIB 
CGILIB . INC 
COLOURS . INC 
VIDEO. INC 

drive: \foo3C\occamlib\examples 

EXAMPLE. OCC 

drive: \foo3C\boards 
B419.LIB 
B419A.LIB 
B437.LIB 

drive: \F003C\BOARDS\ SOURCE 
B419.C 
B437.C 
FSTORE.H 
FSTOREI . H 
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B IMS B419 hardware 
overview 


B.1 Description 

The IMS B419 combines the IMS G300B Colour Video Controller (CVC) with the 
IMS T800 32 bit Floating Point Transputer to form a high performance graphics 
system. Two Mbytes of four cycle DRAM provides a general purpose store suffi- 
cient to run large applications such as windowing environments. Two Mbytes of 
Video RAM provide arbitary screen resolutions up to a maximum of 1280 x 1024 
8 bit/pixel with unrestricted screen formats at resolutions below this. 



Figure B.1 Block diagram 


B.1.1 Introduction 

The IMS B41 9 is one of a range of INMOS TRAnsputer Modules (TRAMs). TRAMs 
are board level transputers with a simple, standardised interface. They integrate 
processor, memory and peripheral functions allowing powerful, flexible, transputer 
based systems to be produced with the minimum of design effort 1 . 

1 Further details of the TRAM/motherboard philosophy and the full electrical and mechanical specification of TRAMs can 
be found in technical notes Duahln-Une Transputer Modules (TRAMs) and Module Motherboard Architecture which we in- 
cluded later in this databook. The Transputer Databook may also be required. This » available as a separate publication 
from INMOS. 
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The IMS B41 9 implements a complete high performance graphics subsystem. The 
frame store consists of 2 Mbytes of dual ported Video RAM which supports dis- 
plays of arbitrary resolution at 8 bit/pixel. The resolution of the system is program- 
mable and is only limited by the CVCs maximum dot rate (100MHz). The CVC is 
configured by an IMS T800 which is provided with 2 Mbytes of 200ns cycle DRAM. 
This store is available for screen manipulation workspace and general program 
memory. The processor can be used to implement graphic primitives directly or as 
an intelligent channel, receiving image data from other transputers via its four bidi- 
rectional links at data rates of up to 6.8 Mbytes/sec. This makes the IMS B419 use- 
ful for applications from acting as part of an embedded system in industrial control, 
to a graphics output for a 3D graphical supercomputer. 

B.1.2 Screen sizes 

Screen sizes are set by writing to a few registers in the G300B CVC, and can be 
chosen to suit the application. Suppose, for instance, an 8.5 x 11 sheet of paper 
(in landscape), represented by a screen with 100 pixels per inch. This would need 
an 1100 x 850 display, a format not normally available from a hardware solution. 
The G300B gives a line width in multiples of 4 pixels, which makes it simple to pro- 
duce this screen. As well as producing special screens such as 11 x 8.5, many of 
the standard screens can also be produced; indeed the user can switch between 
screen formats, the display clock frequency, and even the source of the input clock, 
all by simply changing the G300B registers and other registers on the board by soft- 
ware. 

Some examples of possible screen sizes are given in Table B.l. All the screens 
in the table are for 8 bits per pixel. 


Screen 

Size 

Pixels 

Aspect Ratio 

Inter- 

lace 

CGA 

320 x 240 

1.333 

no 

EGA 

640 x 350 

1.829 

no 

VGA 

640 x 480 

1.333 

no 

Enh VGA 

800 x 600 

1.333 

no 

Ext VGA 

1024 x 768 

1.333 

no 

11 x 8.5 

1100x850 

1.294 

no 

11 x 8.5 

1164x900 

1.293 

no 


1024x 1024 

1.0 

no 


1280x 1024 

1.25 

no 

A5 

1216x860 

1.414 

no 


Table B.l A selection of possible screen sizes 


B.l. 3 Subsystem signals 

The user may require the G300B Graphics TRAM to control a network of transput- 
ers and/or other TRAMs. A set of control signals are provided which enables the 
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master to control these slaves or subsystems. The Subsystem port consists of 
three signals: SubSystemReset and SubSystemAnalyse, which enables the 
master to reset and analyse its subsystem; and SubSystemnotError, which is 
used to monitor the error flag in the subsystem. These signals are accessible to 
the processor as a set of memory-mapped registers. 


Register 

Hardware byte ad- 
dress 

Asserted 

state 

SubSystemReset (Wr only) 

#00000000 

1 

SubSystemAnalyse (Wr only) 

#00000004 

1 

SubSystemError (Rd only) 

#00000000 

1 


Table B.2 


B.1.4 Memory Map 

The video memory (VRAM) on the IMS B419 can be arranged to be either contigu- 
ous with the DRAM or separately mapped. The IMS F003C requires that the VRAM 
must be contiguous with the DRAM; so JP4 must be fitted, and JP5 removed when 
the IMS B419 is installed. The resulting memory map is shown in Figure B.2. 




# 5FFFFFFF 


G300B 




tmm 


Sub-system Reg 



/ 

# 00000000 


1 1 

" # 803FFFFF 


VRAM 




# 80200000 



# 801FFFFF 


DRAM 

#80001000 


Internal RAM 



# 80000000 

Contiguous 



Figure B.2 Address map 


Users are advised not to access the IMS G300B directly, but to use the routines 
provided by the IMS F003C. 
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B.1.5 Pixel clock selection 

The IMS G300B requires a clock to control the movement of pixel data, and gener- 
ate timing signals. It has a phase-locked loop (PLL) which can generate the high 
frequency pixel clock from a low frequency input clock. The PLL can generate fre- 
quencies from 25MHz upwards. 

The IMS B419 provides a choice of clocking schemes which are described in detail 
in the IMS B419 hardware reference guide. The IMS F003C uses the 5MHz TRAM 
clock in conjunction with the IMS G300’s on-chip phase locked loop. This allows 
the use of any clock frequency which is a multiple of 5MHz from 25MHz — 
100MHz. If any other clock frequency is required, the nearest multiple of 5MHz 
should be used. This has been found to give satisfactory results with all types of 
video monitor, and screen resolution. 


B.1.6 Jumper selection 

Five jumper links are used to select the IMS G300B clock source and to configure 
the memory map of the IMS B41 9. Jumpers are labelled JPx where a jumper is ei- 
ther installed or absent between two pin posts. 


Jumper 

Function 

JP1 

Always remove on IMSB419-4 

JP2 

Do not fit 

JP3 

Always fit 

JP4 

Select contiguous VRAM 

JP5 

Select non-contiguous VRAM 


Table B.3 

For IMS F003C compatibility, JP4 must be fitted and JP5 removed. 
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B.2 Board layout 



Figure B.3 
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B.2.1 Video and sync outputs 

The G300B CVC can be programmed to generate timing which complies with both 
the RSI 70a and EIA-343 video standard. The outputs are designed to drive a 75R 
line directly. The RGB analogue outputs and synchronising signals are on five SMB 
connectors as shown below. If the display monitor accepts composite sync on one 
of its video inputs the sync outputs may be left unconnected. SMB identification 
from top to bottom of the board. Sync, information is output on all three video sig- 
nals. 


Composite blank 

Input/Output 

Vertical Sync 

Output 

Composite or Horizontal Sync 

Output 

Blue 

Output 75R 

Green 

Output 75R 

Red 

Output 75R 
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C IMS B437 hardware 
overview 


C.1 Description 

The IMS B437 consists of an IMS T805 transputer; with 1 Mbyte of dual port video 
RAM which is directly addressed by the transputer, and an IMS G332 colour video 
controller which is connected to the serial ports of the video RAMs. 

The IMS G332 can be programmed by the transputer to generate almost any re- 
quired video timing and display resolution; the only restriction being that maximum 
clock frequencies and memory size limits are not exceeded. Because of its ability 
to drive many types of display monitor at a wide range of resolutions, the IMS B437 
is suitable for a variety applications. It is able to generate high resolution displays, 
VGA-type displays and TV standard images with correct sync patterns and inter- 
lacing. The 1 5 and 1 6 bit/pixel true colour modes provide highly realistic colour ren- 
dition. 

The IMS B437 can be used with the IMS B429 to build a high performance image 
processing system, which fits on a single IMS B008 PC add-in card or IMS B014 
VME card. It is also suitable for use in any transputer application where graphical 
output is required and space is limited. 



Figure C.1 Block diagram 
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C.2 Memory map 


Feature 

Address 

DRAM (1Mb) 

IMS G332 

Board control 

0x80001000- 
0x801 00FFF 

0x00000000 - 
0x3FFFFFFF 

0x40000000 - 
0x4000001 F 


Table C.1 IMS B437 Memory Map 

Users are advised that it is not necessary to write to the IMS G332 or the board 
control registers directly. They should use the IMS F003 to program the IMS G332. 


C.3 Display formats 

Pixel widths can be 1 ,2,4,8, 1 5 or 1 6 bits. The 1 ,2,4, and 8 bit modes are pseudo-co- 
lour modes which use the IMS G332’s Colour Look-Up Table to select from a much 
larger colour space (8 bits/DAC). The 15 and 16 bit modes drive the DACs directly 
(but use the Look-Up Tables to perform gamma-correction). In the 15 and 16 bit 
modes, the pixel clock speed is limited to a maximum of 50MHz. This is more than 
adequate for producing full colour displays at VGA and TV standard resolutions. 
The required pixel width is selected by programming the IMS G332, and board 
control register 5. Pixels are displayed from consecutively addressed words in 
memory, starting at the address specified by TopOfScreen/LineStart. The format 
of pixels within each word is that the pixels are output to the screen starting from 
the least-significant end of the word. 


C.4 Colour video controller 

The IMS B437 uses an IMS G332 Colour Video Controller. This device generates 
fully programmable video timing which allows the IMS B437 to drive a wide variety 
of display monitors with a wide variety of display resolutions. Examples of typical 
formats which are supported by the IMS B437, and the amount of memory remain- 
ing for program use, are: 

• 1 screen of 1024 x 768 by 8 bit pixels, 256k program space 

• 3 screens of 640 x 480 by 8 bit pixels, 124k program space 

• 1 screen of 640 x 480 by 15/16 bit pixels, 424k program space 

Table C.2 gives parameter lists for programming the IMS G332 to drive two typical 
monitors and display resolutions. The first is for a high resolution 8-bit/pixel display, 
on a monitor with 48kHz horizontal scan rate. The other is for a true-colour display 
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on a monitor with 31.25kHz horizontal scan rate. For details of how to determine 
the correct parameters for other combinations of monitor and resolution, refer to 
the IMS G332 datasheet [3]. 


Register 

1024x768x8 

640x480x15 

Vertical Scan 

60 

60 

Horizontal Scan 

48kHz 

31.25kHz 

Pixel Clock 

60.0MHz 

25.0MHz 

Half Sync 

12 

9 

Back Porch 

24 

18 

Display 

256 

160 

Short display 

100 

60 

Broad Pulse 

132 

82 

VSync 

6 

6 

VPreEqualise 

6 

6 

VPostEqualise 

6 

6 

VBIank 

48 

64 

VDisplay 

1536 

960 

LineTime 

312 

200 

LineStart 

* 

* 

Memlnit 

490 

240 

TransferDelay 

22 

16 

Boot Location 

44 

37 

Control Register A 

#342015 

#442015 

Control Register B 

0 

0 


Table C.2 Example parameter lists 


The LineStart/TbpOfScreen register must be programmed with the byte offset of 
the live screen from the bottom of memory. For example, if the screen has been 
placed at machine address #80020000, these registers must both be programmed 
with #20000. The video RAM serial output shift register on the IMS B437 is 512 
words (2048 bytes) long. Hence, the IMS G332 must be configured to increment 
the VRAM transfer address by 512 after each transfer. This is independent of the 
pixel width selected. Note that the sum of Memlnit and TransferDelay should 
equal the length of the video RAM serial output shift register in pixels divided by 
four. The requirement for each pixel width is summarised in Table C.3. The times 
defined by the other datapath registers are always specified in multiples of four pix- 
els: i.e. in periods of PixelClock/4. 
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Pixel 

Width 

Meminit + TransferDelay 

15/16 

256 

8 

512 

4 

1024 

2 

2048 

1 

4096 


Table C.3 


C.5 Control register programming 

There are some features of the IMS G332 which must always be operated in a par- 
ticular way on the IMS B437. These are set by programming Control Register A 
at start up, and are summarised in Table C.4. Control register B must always be 
programmed with 0. In particular, note that on the IMS B437, the IMS G332 must 
always be operated in interleaved mode: this has no effect on how the video timing 
parameters are calculated. Control register bits which are not specified in the Table 
will depend on the type of monitor being driven, number of bits per pixel, cursor 
enable/disable, etc. Users are recommended to use the routines provided in the 
main part of this user manual to program the IMS G332. 
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Bit 

Function 

Program With 

0 

Enable VTG 


1 

Enable Interlace 


2 

Interlace Format 


3 

Mode 

0 (master) 

4 

Plain Sync 


5 

Separate Sync 

0 (composite) 

6 

Sync On Video 


7 

Pedestal 


8 

Blank I/O 

0 (output) 

9 

Blank Function 

0 

10 

Force Blanking 

0 (Unblanked) 

11 

Disable Blanking 

0 (enabled) 

12 

Address Increment 

0 

13 

Address Increment 

1 

14 

Disable Xfer cycles 

0 

15 

Pixel delay 

0 

16 

Pixel delay 

0 

17 

Pixel delay 

0 

18 

Enable Interleaving 

1 

19 

Delayed Sampling 

0 

20 

Bits/pixel 


21 

Bits/pixel 


22 

Bits/pixel 


23 

Disable Cursor 



Table C.4 IMS G332 Control Register A 


C.6 Hardware cursor 

The IMS G332 provides a 64 x 64 hardware cursor, the location of which is speci- 
fied by the Cursor Position register in the IMS G332. The cursor may be blanked 
by setting bit 23 in IMS G332 control register A. 

C.7 Events 

The IMS B437 uses the IMS T805’s Event Channel input to allow application soft- 
ware to synchronise to the vertical flyback portion of the video display cycle. The 
rising edge of the IMS G332's Framelnactive signal sets the event latch which as- 
serts EventReq to the IMS T805. The event latch is cleared by EventAck from the 
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transputer which occurs when a user-provided event handler process is sched- 
uled, and also by a hardware reset applied to the IMS B437. 

Software can synchronise to Framelnactive by performing a channel input from 
the IMS T805’s Event channel. It is recommended that all accesses to the IMS 
G332 are performed during vertical blanking. 


C.8 Board control registers 

This set of 8 one-bit registers is used to set up the board, reset the IMS G332, and 
select between true colour and pseudo-colour modes. All of these functions must 
be set up as part of an initialisation procedure, while the IMS G332 is not active. 
Hence, registers 0-6 should only be written while the IMS G332 is held in reset; 
ie when register 7 is 0. The recommended startup procedure is described below. 


Register Number 

Function 

Address 

0 

Control 0 

0x40000000 

1 

Control 1 

0x40000004 

2 

Control 2 

0x40000008 

3 

Control 3 

0x4000000C 

4 

Control 4 

0x40000010 

5 

Colour Mode 

0x40000014 

6 

Control strobe 

0x40000018 

7 

Reset IMS G332 

0x4000001C 


Table C.5 Board Control Registers 


10.4.1 Colour mode select register 

The IMS B437 operates in two distinct modes: pseudo-colour mode, and true co- 
lour mode. The pseudo-colour modes use 1,2,4 or 8 bits/pixel; the true colour 
modes use 15 or 16 bits/pixel. These modes are selected by programming the 
IMS G332 and also by board control register 5. This register must be written with 
0 to use any of the pseudo-colour modes, and with 1 to use either of the true colour 
modes. The register is cleared (to pseudo-colour mode) by an external hardware 
reset to the IMS B437. 


10.4.2 IMS G332 reset register 

The IMS G332 can be reset at any time by writing 0 to board control register 7, wait- 
ing for a minimum of 20^s, and then writing 1 to this register. The IMS G332 is held 
in the reset state until this register is written with 1. This register is cleared (to 0) 
by an external hardware reset to the IMS B437, holding the IMS G332 in reset. 
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10.4.3 Startup procedure 

The recommended initialisation procedure for the IMS B437 is as follows: 

1 Assert reset to the IMS G332 to stop all of its activity, by writing 0 to board 
control register 7. The IMS G332 will be in the reset state after a harware 
reset to the board, but it is recommended that it should always be reset ex- 
plicitly. 

2 Write 0 to control register 6. 

3 Write the pattern 01000 to registers 0-4 respectively. 

4 Write 1 to control register 6. 

5 Write 0 to control register 6. 

6 Write the appropriate value to the Colour Mode register. 

7 De-assert reset to the IMS G332, by writing 1 to board control register 7. 

8 Continue with the initialisation procedure for the IMS G332, as described 
in the IMS G332 data sheet. 


C.9 Video outputs 

The video outputs are terminated by 75Q to ground on the IMS B437, to match a 
terminated 75Q line. Clamping diodes to both supply rails protect the IMS G332 
video outputs against the application of hostile voltages. The IMS B437 drives 
1.0V video signals (including sync) into a properly terminated 75Q line. Three 
SMR connectors carry the Red, Green, and Blue video signals, with sync available 
on all outputs. Another SMR connector carries the composite sync output from the 
IMS G332 which allows monitors that require a separate sync input to be driven 
easily. Sync output on the video signals can be turned off by appropriate program- 
ming of the IMS G332. 
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C.10 Board layout 



C.11 Accessories 

The IMS B437 is supplied with a set of four cables which fit the SMR connectors 
on the IMS B437 and are terminated at their free end with BNC male connectors. 
The cables are 1m in length. 
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Poughkeepsie. NY 12603-3633 
Tel (914)454-8813 


NORTH CAROLINA 
4505, Far Meadow Lane 
Suite 220 
Raieigh, NC 27607 
Tel (919) 787-6555 

TEXAS 

1310. Electronics Drive 
Carrollton, TX 75006 
Tel (214)466-7402 

ASIA/PACIEIC 

AUSTRALIA 
NSW 2027 EDGECLIFF 
Suite 211, Edgediff Centre 
203-233. New South Head Road 
Tel (61-2) 327.39.22 
Telex 071 126911 TCAUS 
Telefax (61-2)327 61.76 

HONG KONG 

WAN C HA I 

22nd Floor - Hopewell Centre 
1B3. Queer 1 * Road East 
Tel (852-5)8615788 
Telex 60955 ESGIES HX 
Telefax (852-5) 8656589 

INDIA 

NEW DELH1 110001 

Liarson Office 
62. Upper Ground Floor 
World Trade Centre 
Barakhamba Lane 
Tel 3715191 

Telex 031-66816 STMI IN 
Telefax 3715192 

KOREA 

SEOUL 121 

8th Floor Shinwon Building 
823-14, Yuksam-Oong 
Kang-Naro-Gw 
Tel (82-2)553-0399 
Terex SGSKOR K29998 
Telefax (82-2) 552-1051 

MALAYSIA 

PULAU PINANG 10400 

4th i toor. Suite 4-03 
Bangunan FOP 123D Jaian An- 

Tel (04) 379735 
Telefax (04)379816 

SINGAPORE 

SINGAPORE 2056 

28 Ang Mo Kk> - Industrial Park, 2 

Tel (65)48214 11 

Terex RS 55201 ESGIES 

Telefax. (65) 4820240 

TAIWAN 

TAIPEI 

12th Floor 

571 . Tun Hua South Road 
Tel (886-2) 755-4111 
Telex 10310 ESGIE TW 
Telefax (886-2) 755-4006) 

JAPAN 

TOKYO 108 

Nisseki Taxanawa Bid 4F 
2-18-10 Takanawa 
M.nato-ku 

Tel. (81-3) 3280-4125 
Telefax <81-3)3280-4131 






Customer Checklist for IMS F003 


Licence terms and conditions 


Ring binder containing 



Shrink wrapped documentation 




2D graphics occam and C 
libraries user guide 




Software problem report form 



2 x F003 5-1/4in diskettes 



2 x F003 3-1/2in diskettes 



Product registration form 









SOFTWARE PROBLEM REPORT 


oonmos® 


This form should be used to report a problem with INMOS software to Software Support, INMOS Business 
Center, SGS-THOMSON Microelectronics at one of the following addresses: 


Asia/Pacific 

France 

Germany 

Italy 

Japan 

Scandanavia 

UK 

USA 


28 Ang Mo Kio Industrial Park 2, Singapore 2056. 

7 Avenue Gallieni, BP 93, 94253 Gentilly Cedex. 

Bretonischer Ring 4, 8011 Grasbrunn, Munchen. 

V.le Milanofiori, Strada 4, Palazzo A/4/A, 20090 Assago (Ml). 

Nisseki Takanawa Building 4F, 2-18-10 Takanawa, Minato-ku, Tokyo 108. 
Borgarfjordsgaten, 13 Box 1094, S-16421 Kista, Sweden. 

Planar House, Parkway Globe Park, Marlow, Bucks SL7 1YL. 

1310 Electronics Drive, Carrollton, TX 75006. 


Name of Field Application Engineer: Has FAE been informed? 

Date of report: Is a reply required? 

Originator of report: Originator’s reference: 


(please include name, address 
and telephone number) 


Product name and number, version number and date: 

Identity of software component with problem: 

Host hardware and OS version: 

Master transputer type and memory size: 

Tick one of the following items: 

Documentation error or inadequacy Q 

Serious software bug (system crashes) Q 
Other software bug Q 

Suggestion for design change Q 

Description of problem (one problem only) continue on separate sheet if necessary 

(If there is something you cannot do that you expected to be able to do please describe this) 


72-TDS-1 56-03 



INMOS Software 

LICENCE TERMS AND CONDITIONS 
SINGLE USER - SINGLE CENTRAL PROCESSING UNIT 

IMPORTANT - read terms and conditions before using the software; if your proposed 
use of the software is not compatible with these terms, return it within 21 days, unused 
and in its original packing, to your supplier who will arrange a refund of the price paid. 

This software package and associated manuals ('the Software’) is supplied by INMOS Limited (‘INMOS’) either 
directly or via a distributor and is licensed by INMOS only upon the the following terms and conditions which the 
Licensee will be deemed to have accepted by using the Software. Such terms apply In place of any inconsistent 
provisions contained in the supplier’s Terms and Conditions of Sale and shall prevail over any other terms and 
conditions whatsoever. 

1 All copyright and other intellectual property rights in the Software are and shall remain the property of 
INMOS or its licensor absolutely and no title in the same shall pass to Licensee. 

2 Commencing on use of the Software and continuing until any breach of these terms, INMOS hereby 
grants a non-exclusive licence to Licensee for the use of the Software by a single user on a single ma- 
chine. 

3 Copying the Software is not permitted except to the extent necessary to provide Licensee with back-up. 
Any copy made by Licensee must include all copyright and proprietary information notices appearing 
on the copy provided by INMOS or its distributor. 

4 INMOS warrants that it has the right to grant the licence contained in paragraph 2 above. 

5 Provided that Licensee completes and returns to INMOS the accompanying Product Registration Form 
within 1 4 days of provision of the Software, INMOS will until six months from such provision make avail- 
able to Licensee any updates that are generally released by INMOS to existing licensees of the Soft- 
ware. 

6 Subject to paragraphs 4 and 5, the Software is transferred to Licensee “AS IS", “WHERE IS” AND ALL 
CONDITIONS, WARRANTIES AND REPRESENTATIONS EXPRESSED OR IMPLIED BY STATUTE, COM- 
MON LAW OR OTHERWISE IN RELATION TO THE SOFTWARE ARE HEREBY EXCLUDED (INCLUDING 
BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR 
PURPOSE). INMOS SHALL NOT BE LIABLE FOR LOSS, DAMAGE OR INJURY, DIRECT OR INDIRECT, 
FORSEEABLE OR OTHERWISE (INCLUDING LOSS OF PROFITS, GOODWILL OR OTHER SPECIAL, IN- 
CIDENTAL, CONSEQUENTIAL OR PUNITIVE DAMAGES) EVEN IF INMOS HAD BEEN ADVISED OF THE 
POSSIBILITY OF THE SAME, WHETHER CAUSED BY THE NEGUGENCE OF INMOS OR OTHERWISE 
EXCEPT LIABILITY ARISING FROM THE DUE COURSE OF LAW. 

7 Licensee shall not transfer or assign all or any part of the licence granted herein nor shall Licensee grant 
any sub-licence thereunder without prior written consent of INMOS. 

8 Upon termination of this licence for whatever reason Licensee shall immediately return the Software and 
all copies in his control or possession to INMOS or its distributor. 


72 TDS043 06 


December 1991 




Branos Registration 396 0 2 

PRODUCT REGISTRATION FORM 


INMOS Product Purchased: 

(See label on packaging or despatch note) 

Date: 

Customer Contact Name: 

Title: 

Organisation: 


Address 



Tel. No: Fax No: 

Did you purchase this INMOS product from 
I I Distributor 

Please name which Distributor 
It would be helpful if you would also provide the information requested overleaf 


Telex No: 

□ INMOS 


Please retain this portion 




animos 


Registration 


39602 


To ensure future INMOS support of this product, please complete the form overleaf and return it 
to the appropriate INMOS address no later than two weeks after receipt of product. The above 
Registration No. should be quoted when making any telephone or written enquiries. 


FRANCE & BENELUX 

INMOS Business Centre 
SGS-THOMSON 
Microelectronics SA 
7 avenue Gallieni 
BP 93 

94253 Gentilly Cedex 
FRANCE 


JAPAN 

INMOS Business Centre 
SGS-THOMSON 
Microelectronics K.K. 
Nisseki Takanawa Building. 
4th Floor 

18-10 Takanawa 2-chome 
Minato-ku 

Tokyo 108 
JAPAN 


SOUTHERN EUROPE 

INMOS Business Centre 
SGS-THOMSON 
Microelectronics SpA 
V.le Mitanofiori 
Strada 4 
PaJazzo A/4/A 
20090 Assago (Ml) 
ITALY 


ASIA PACIFIC 

INMOS Business Centre 
SGS-THOMSON 
Microelectronics Pte Ltd. 

28 Ang Mo Kio Industrial Park 
SINGAPORE 2056 


CENTRAL EUROPE 

INMOS Business Centre 
SGS-THOMSON 
Microelectronics GmbH 
Neukeferloh Technopark 
Bretonischer Ring 4 
8011 Grasbrunn 
GERMANY 


UNITED KINGDOM 

INMOS Business Centre 
SGS-THOMSON 
Microelectronics Ltd. 

2 Planar House 
Parkway Globe Park 
Marlow 

Buck* SL7 1 YL 

ENGLAND 


SCANDINAVIA 

INMOS Business Centre 

SGS-THOMSON 

Microelectronics 

Borgarfjordsgatan 13 

Box 1094 

S- 16421 Kista 

SWEDEN 


N & S AMERICA 

INMOS Business Centre 
Headquarters (USA) 
SGS-THOMSON 
Microelectronics Inc. 
2225 Executive Circle 
PO Box 16000 

Colorado Springs 

Colorado 80935-6000 
USA 



rz 7 SGS-THOMSON 
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Reason for purchase: 

□ 1. Evaluation □ 2. Prototyping □ 3. Production 



Application 

I | Military 

1 | Office Automation 

1 | Telecoms 

1 1 Computing 

1 1 Industrial 

1 1 Other 


Host System 

□ PC 

□ VAX 

1 I Sun 3 

1 1 Other 

1 1 Sun 4 



Software Used 

□ C 

I I occam 

I I Fortran 

I I Other 
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ftfOfTIOS Registration 39081 

PRODUCT REGISTRATION FORM 

INMOS Product Purchased: Date: 

(See label on packaging or despatch note) 

Customer Contact Name: Title: 

Organisation: 

Address 

Tel. No: Fax No: 

Did you purchase this INMOS product from 
I | Distributor 

Please name which Distributor 

It would be helpful if you would also provide the information requested overleaf 


Telex No: 

□ INMOS 


Please retain this portion 



Elmos 


Registration 3 9 0 C 


To ensure future INMOS support of this product, please complete the form overleaf and return it 
to the appropriate INMOS address no later than two weeks after receipt of product. The above 
Registration No. should be quoted when making any telephone or written enquiries. 


FRANCE & BENELUX 

INMOS Business Centre 
SGS-THOMSON 
Microelectronics SA 
7 avenue Gallieni 
BP 63 

94253 Gentilly Cedex 
FRANCE 


SOUTHERN EUROPE 
INMOS Business Centre 
SGS-THOMSON 
Microelectronics SpA 
V ie Milanofbri 
Strada 4 
Palazzo A/4/A 
20090 As sago (Ml) 
ITALY 


CENTRAL EUROPE 

INMOS Business Centre 
SGS-THOMSON 
Microelectronics GmbH 
Neukeferloh Technopark 
Bretonischer Ring 4 
8011 Grasbrunn 
GERMANY 


SCANDINAVIA 

INMOS Business Centre 

SGS-THOMSON 

Microelectronics 

Borgarfjordsgatan 13 

Box 1094 

S- 16421 Kista 

SWEDEN 


JAPAN 

INMOS Business Centre 
SGS-THOMSON 
Microelectronics K.K. 
Nisseki Takanawa Building, 
4th Floor 

18-10 Takanawa 2-chome 

Minato-ku 


Tokyo 108 
JAPAN 


ASIA PACIFIC 

INMOS Business Centre 
SGS-THOMSON 
Microelectronics Pte Ltd. 

28 Ang Mo Kio Industrial Park 
SINGAPORE 2056 


UNITED KINGDOM 

INMOS Business Centre 
SGS-THOMSON 
Microelectronics Ltd. 

2 Planar House 
Parkway Globe Park 
Marlow 

Bucks SL7 1YL 

ENGLAND 


N & S AMERICA 

INMOS Business Centre 
Headquarters (USA) 
SGS-THOMSON 
Microelectronics Inc. 
2225 Executive Circle 
PO Box 16000 
Colorado Springs 

Colorado 80935-6000 
USA 
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Reason for purchase: 

□ 1. Evaluation □ 2, Prototyping 03. Production 


Software Used 

□ C 

□ occam 

I I Fortran 

I I Other 


Host System 

□ PC 

□ VAX 

1 1 Sun 3 

1 1 Other 

1 1 Sun 4 




Application 

1 1 Military 

1 1 Office Automation 

1 1 Telecoms 

1 1 Computing 

1 1 Industrial 

1 1 Other 


72 TRN 199 01 



